/ Hex Artifact Content
Login

Artifact f222bd196b55a2e73b1427400d5aa97841787167:


0000: 2f 2a 0a 2a 2a 20 32 30 30 35 20 44 65 63 65 6d  /*.** 2005 Decem
0010: 62 65 72 20 31 34 0a 2a 2a 0a 2a 2a 20 54 68 65  ber 14.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d   author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74  s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e  his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a    In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c   a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73   here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61  ing:.**.**    Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e  y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20  d not evil..**  
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66    May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79  orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67  ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20  ive others..**  
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20    May you share 
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61  freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79  king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a  ou 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 0a 2a 2a 0a 2a 2a 20 54 68 69 73  *****.**.** This
0180: 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 61   file contains a
0190: 6e 20 65 78 61 6d 70 6c 65 20 69 6d 70 6c 65 6d  n example implem
01a0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 61 6e 20 61  entation of an a
01b0: 73 79 6e 63 68 72 6f 6e 6f 75 73 20 49 4f 20 0a  synchronous IO .
01c0: 2a 2a 20 62 61 63 6b 65 6e 64 20 66 6f 72 20 53  ** backend for S
01d0: 51 4c 69 74 65 2e 0a 2a 2a 0a 2a 2a 20 57 48 41  QLite..**.** WHA
01e0: 54 20 49 53 20 41 53 59 4e 43 48 52 4f 4e 4f 55  T IS ASYNCHRONOU
01f0: 53 20 49 2f 4f 3f 0a 2a 2a 0a 2a 2a 20 57 69 74  S I/O?.**.** Wit
0200: 68 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 49  h asynchronous I
0210: 2f 4f 2c 20 77 72 69 74 65 20 72 65 71 75 65 73  /O, write reques
0220: 74 73 20 61 72 65 20 68 61 6e 64 6c 65 64 20 62  ts are handled b
0230: 79 20 61 20 73 65 70 61 72 61 74 65 20 74 68 72  y a separate thr
0240: 65 61 64 0a 2a 2a 20 72 75 6e 6e 69 6e 67 20 69  ead.** running i
0250: 6e 20 74 68 65 20 62 61 63 6b 67 72 6f 75 6e 64  n the background
0260: 2e 20 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68  .  This means th
0270: 61 74 20 74 68 65 20 74 68 72 65 61 64 20 74 68  at the thread th
0280: 61 74 20 69 6e 69 74 69 61 74 65 73 0a 2a 2a 20  at initiates.** 
0290: 61 20 64 61 74 61 62 61 73 65 20 77 72 69 74 65  a database write
02a0: 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 74   does not have t
02b0: 6f 20 77 61 69 74 20 66 6f 72 20 28 73 6f 6d 65  o wait for (some
02c0: 74 69 6d 65 73 20 73 6c 6f 77 29 20 64 69 73 6b  times slow) disk
02d0: 20 49 2f 4f 0a 2a 2a 20 74 6f 20 6f 63 63 75 72   I/O.** to occur
02e0: 2e 20 20 54 68 65 20 77 72 69 74 65 20 73 65 65  .  The write see
02f0: 6d 73 20 74 6f 20 68 61 70 70 65 6e 20 76 65 72  ms to happen ver
0300: 79 20 71 75 69 63 6b 6c 79 2c 20 74 68 6f 75 67  y quickly, thoug
0310: 68 20 69 6e 20 72 65 61 6c 69 74 79 0a 2a 2a 20  h in reality.** 
0320: 69 74 20 69 73 20 68 61 70 70 65 6e 69 6e 67 20  it is happening 
0330: 61 74 20 69 74 73 20 75 73 75 61 6c 20 73 6c 6f  at its usual slo
0340: 77 20 70 61 63 65 20 69 6e 20 74 68 65 20 62 61  w pace in the ba
0350: 63 6b 67 72 6f 75 6e 64 2e 0a 2a 2a 0a 2a 2a 20  ckground..**.** 
0360: 41 73 79 6e 63 68 72 6f 6e 6f 75 73 20 49 2f 4f  Asynchronous I/O
0370: 20 61 70 70 65 61 72 73 20 74 6f 20 67 69 76 65   appears to give
0380: 20 62 65 74 74 65 72 20 72 65 73 70 6f 6e 73 69   better responsi
0390: 76 65 6e 65 73 73 2c 20 62 75 74 20 61 74 20 61  veness, but at a
03a0: 20 70 72 69 63 65 2e 0a 2a 2a 20 59 6f 75 20 6c   price..** You l
03b0: 6f 73 65 20 74 68 65 20 44 75 72 61 62 6c 65 20  ose the Durable 
03c0: 70 72 6f 70 65 72 74 79 2e 20 20 57 69 74 68 20  property.  With 
03d0: 74 68 65 20 64 65 66 61 75 6c 74 20 49 2f 4f 20  the default I/O 
03e0: 62 61 63 6b 65 6e 64 20 6f 66 20 53 51 4c 69 74  backend of SQLit
03f0: 65 2c 0a 2a 2a 20 6f 6e 63 65 20 61 20 77 72 69  e,.** once a wri
0400: 74 65 20 63 6f 6d 70 6c 65 74 65 73 2c 20 79 6f  te completes, yo
0410: 75 20 6b 6e 6f 77 20 74 68 61 74 20 74 68 65 20  u know that the 
0420: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 79 6f 75 20  information you 
0430: 77 72 6f 74 65 20 69 73 0a 2a 2a 20 73 61 66 65  wrote is.** safe
0440: 6c 79 20 6f 6e 20 64 69 73 6b 2e 20 20 57 69 74  ly on disk.  Wit
0450: 68 20 74 68 65 20 61 73 79 6e 63 68 72 6f 6e 6f  h the asynchrono
0460: 75 73 20 49 2f 4f 2c 20 74 68 69 73 20 69 73 20  us I/O, this is 
0470: 6e 6f 20 74 68 65 20 63 61 73 65 2e 20 20 49 66  no the case.  If
0480: 0a 2a 2a 20 79 6f 75 72 20 70 72 6f 67 72 61 6d  .** your program
0490: 20 63 72 61 73 68 65 73 20 6f 72 20 69 66 20 79   crashes or if y
04a0: 6f 75 20 74 61 6b 65 20 61 20 70 6f 77 65 72 20  ou take a power 
04b0: 6c 6f 73 65 20 61 66 74 65 72 20 74 68 65 20 64  lose after the d
04c0: 61 74 61 62 61 73 65 0a 2a 2a 20 77 72 69 74 65  atabase.** write
04d0: 20 62 75 74 20 62 65 66 6f 72 65 20 74 68 65 20   but before the 
04e0: 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 77 72 69  asynchronous wri
04f0: 74 65 20 74 68 72 65 61 64 20 68 61 73 20 63 6f  te thread has co
0500: 6d 70 6c 65 74 65 64 2c 20 74 68 65 6e 20 74 68  mpleted, then th
0510: 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 63 68  e.** database ch
0520: 61 6e 67 65 20 6d 69 67 68 74 20 6e 65 76 65 72  ange might never
0530: 20 6d 61 6b 65 20 69 74 20 74 6f 20 64 69 73 6b   make it to disk
0540: 20 61 6e 64 20 74 68 65 20 6e 65 78 74 20 75 73   and the next us
0550: 65 72 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74  er of the.** dat
0560: 61 62 61 73 65 20 6d 69 67 68 74 20 6e 6f 74 20  abase might not 
0570: 73 65 65 20 79 6f 75 72 20 63 68 61 6e 67 65 2e  see your change.
0580: 0a 2a 2a 0a 2a 2a 20 59 6f 75 20 6c 6f 73 65 20  .**.** You lose 
0590: 44 75 72 61 62 69 6c 69 74 79 20 77 69 74 68 20  Durability with 
05a0: 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 49 2f 4f  asynchronous I/O
05b0: 2c 20 62 75 74 20 79 6f 75 20 73 74 69 6c 6c 20  , but you still 
05c0: 72 65 74 61 69 6e 20 74 68 65 0a 2a 2a 20 6f 74  retain the.** ot
05d0: 68 65 72 20 70 61 72 74 73 20 6f 66 20 41 43 49  her parts of ACI
05e0: 44 3a 20 20 41 74 6f 6d 69 63 2c 20 20 43 6f 6e  D:  Atomic,  Con
05f0: 73 69 73 74 65 6e 74 2c 20 61 6e 64 20 49 73 6f  sistent, and Iso
0600: 6c 61 74 65 64 2e 20 20 4d 61 6e 79 0a 2a 2a 20  lated.  Many.** 
0610: 61 70 70 6c 69 61 74 69 6f 6e 73 20 67 65 74 20  appliations get 
0620: 61 6c 6f 6e 67 20 66 69 6e 65 20 77 69 74 68 6f  along fine witho
0630: 75 74 20 74 68 65 20 44 75 72 61 62 6c 69 74 79  ut the Durablity
0640: 2e 0a 2a 2a 0a 2a 2a 20 48 4f 57 20 49 54 20 57  ..**.** HOW IT W
0650: 4f 52 4b 53 0a 2a 2a 0a 2a 2a 20 41 73 79 6e 63  ORKS.**.** Async
0660: 68 72 6f 6e 6f 75 73 20 49 2f 4f 20 77 6f 72 6b  hronous I/O work
0670: 73 20 62 79 20 6f 76 65 72 6c 6f 61 64 69 6e 67  s by overloading
0680: 20 74 68 65 20 4f 53 2d 6c 61 79 65 72 20 64 69   the OS-layer di
0690: 73 6b 20 49 2f 4f 20 72 6f 75 74 69 6e 65 73 0a  sk I/O routines.
06a0: 2a 2a 20 77 69 74 68 20 6d 6f 64 69 66 69 65 64  ** with modified
06b0: 20 76 65 72 73 69 6f 6e 73 20 74 68 61 74 20 73   versions that s
06c0: 74 6f 72 65 20 74 68 65 20 64 61 74 61 20 74 6f  tore the data to
06d0: 20 62 65 20 77 72 69 74 74 65 6e 20 69 6e 20 71   be written in q
06e0: 75 65 75 65 20 6f 66 0a 2a 2a 20 70 65 6e 64 69  ueue of.** pendi
06f0: 6e 67 20 77 72 69 74 65 20 6f 70 65 72 61 74 69  ng write operati
0700: 6f 6e 73 2e 20 20 4c 6f 6f 6b 20 61 74 20 74 68  ons.  Look at th
0710: 65 20 61 73 79 6e 63 45 6e 61 62 6c 65 28 29 20  e asyncEnable() 
0720: 73 75 62 72 6f 75 74 69 6e 65 20 74 6f 20 73 65  subroutine to se
0730: 65 0a 2a 2a 20 68 6f 77 20 6f 76 65 72 6c 6f 61  e.** how overloa
0740: 64 69 6e 67 20 77 6f 72 6b 73 2e 20 20 53 69 78  ding works.  Six
0750: 20 6f 73 2d 6c 61 79 65 72 20 72 6f 75 74 69 6e   os-layer routin
0760: 65 73 20 61 72 65 20 6f 76 65 72 6c 6f 61 64 65  es are overloade
0770: 64 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 73 71 6c  d:.**.**     sql
0780: 69 74 65 33 4f 73 4f 70 65 6e 52 65 61 64 57 72  ite3OsOpenReadWr
0790: 69 74 65 3b 0a 2a 2a 20 20 20 20 20 73 71 6c 69  ite;.**     sqli
07a0: 74 65 33 4f 73 4f 70 65 6e 52 65 61 64 4f 6e 6c  te3OsOpenReadOnl
07b0: 79 3b 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65  y;.**     sqlite
07c0: 33 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69 76 65  3OsOpenExclusive
07d0: 3b 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 33  ;.**     sqlite3
07e0: 4f 73 44 65 6c 65 74 65 3b 0a 2a 2a 20 20 20 20  OsDelete;.**    
07f0: 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 45 78   sqlite3OsFileEx
0800: 69 73 74 73 3b 0a 2a 2a 20 20 20 20 20 73 71 6c  ists;.**     sql
0810: 69 74 65 33 4f 73 53 79 6e 63 44 69 72 65 63 74  ite3OsSyncDirect
0820: 6f 72 79 3b 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6f  ory;.**.** The o
0830: 72 69 67 69 6e 61 6c 20 69 6d 70 6c 65 6d 65 6e  riginal implemen
0840: 74 61 74 69 6f 6e 73 20 6f 66 20 74 68 65 73 65  tations of these
0850: 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 73 61   routines are sa
0860: 76 65 64 20 61 6e 64 20 61 72 65 0a 2a 2a 20 75  ved and are.** u
0870: 73 65 64 20 62 79 20 74 68 65 20 77 72 69 74 65  sed by the write
0880: 72 20 74 68 72 65 61 64 20 74 6f 20 64 6f 20 74  r thread to do t
0890: 68 65 20 72 65 61 6c 20 49 2f 4f 2e 20 20 54 68  he real I/O.  Th
08a0: 65 20 73 75 62 73 74 69 74 75 74 65 0a 2a 2a 20  e substitute.** 
08b0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20  implementations 
08c0: 74 79 70 69 63 61 6c 6c 79 20 70 75 74 20 74 68  typically put th
08d0: 65 20 49 2f 4f 20 6f 70 65 72 61 74 69 6f 6e 20  e I/O operation 
08e0: 6f 6e 20 61 20 71 75 65 75 65 0a 2a 2a 20 74 6f  on a queue.** to
08f0: 20 62 65 20 68 61 6e 64 6c 65 64 20 6c 61 74 65   be handled late
0900: 72 20 62 79 20 74 68 65 20 77 72 69 74 65 72 20  r by the writer 
0910: 74 68 72 65 61 64 2c 20 74 68 6f 75 67 68 20 72  thread, though r
0920: 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 73 0a 2a  ead operations.*
0930: 2a 20 6d 75 73 74 20 62 65 20 68 61 6e 64 6c 65  * must be handle
0940: 64 20 72 69 67 68 74 20 61 77 61 79 2c 20 6f 62  d right away, ob
0950: 76 69 6f 75 73 6c 79 2e 0a 2a 2a 0a 2a 2a 20 41  viously..**.** A
0960: 73 79 6e 63 68 72 6f 6e 6f 75 73 20 49 2f 4f 20  synchronous I/O 
0970: 69 73 20 64 69 73 61 62 6c 65 64 20 62 79 20 73  is disabled by s
0980: 65 74 74 69 6e 67 20 74 68 65 20 6f 73 2d 6c 61  etting the os-la
0990: 79 65 72 20 69 6e 74 65 72 66 61 63 65 20 72 6f  yer interface ro
09a0: 75 74 69 6e 65 73 0a 2a 2a 20 62 61 63 6b 20 74  utines.** back t
09b0: 6f 20 74 68 65 69 72 20 6f 72 69 67 69 6e 61 6c  o their original
09c0: 20 76 61 6c 75 65 73 2e 0a 2a 2a 0a 2a 2a 20 4c   values..**.** L
09d0: 49 4d 49 54 41 54 49 4f 4e 53 0a 2a 2a 0a 2a 2a  IMITATIONS.**.**
09e0: 20 54 68 69 73 20 64 65 6d 6f 6e 73 74 72 61 74   This demonstrat
09f0: 69 6f 6e 20 63 6f 64 65 20 69 73 20 64 65 6c 69  ion code is deli
0a00: 62 65 72 61 74 65 6c 79 20 6b 65 70 74 20 73 69  berately kept si
0a10: 6d 70 6c 65 20 69 6e 20 6f 72 64 65 72 20 74 6f  mple in order to
0a20: 20 6b 65 65 70 0a 2a 2a 20 74 68 65 20 6d 61 69   keep.** the mai
0a30: 6e 20 69 64 65 61 73 20 63 6c 65 61 72 20 61 6e  n ideas clear an
0a40: 64 20 65 61 73 79 20 74 6f 20 75 6e 64 65 72 73  d easy to unders
0a50: 74 61 6e 64 2e 20 20 52 65 61 6c 20 61 70 70 6c  tand.  Real appl
0a60: 69 63 61 74 69 6f 6e 73 20 74 68 61 74 0a 2a 2a  ications that.**
0a70: 20 77 61 6e 74 20 74 6f 20 64 6f 20 61 73 79 6e   want to do asyn
0a80: 63 68 72 6f 6e 6f 75 73 20 49 2f 4f 20 6d 69 67  chronous I/O mig
0a90: 68 74 20 77 61 6e 74 20 74 6f 20 61 64 64 20 61  ht want to add a
0aa0: 64 64 69 74 69 6f 6e 61 6c 20 63 61 70 61 62 69  dditional capabi
0ab0: 6c 69 74 69 65 73 2e 0a 2a 2a 20 46 6f 72 20 65  lities..** For e
0ac0: 78 61 6d 70 6c 65 2c 20 69 6e 20 74 68 69 73 20  xample, in this 
0ad0: 64 65 6d 6f 6e 73 74 72 61 74 69 6f 6e 20 69 66  demonstration if
0ae0: 20 77 72 69 74 65 73 20 61 72 65 20 68 61 70 70   writes are happ
0af0: 65 6e 69 6e 67 20 61 74 20 61 20 73 74 65 61 64  ening at a stead
0b00: 79 0a 2a 2a 20 73 74 72 65 61 6d 20 74 68 61 74  y.** stream that
0b10: 20 65 78 63 65 65 64 73 20 74 68 65 20 49 2f 4f   exceeds the I/O
0b20: 20 63 61 70 61 62 69 6c 69 74 79 20 6f 66 20 74   capability of t
0b30: 68 65 20 62 61 63 6b 67 72 6f 75 6e 64 20 77 72  he background wr
0b40: 69 74 65 72 20 74 68 72 65 61 64 2c 0a 2a 2a 20  iter thread,.** 
0b50: 74 68 65 20 71 75 65 75 65 20 6f 66 20 70 65 6e  the queue of pen
0b60: 64 69 6e 67 20 77 72 69 74 65 20 6f 70 65 72 61  ding write opera
0b70: 74 69 6f 6e 73 20 77 69 6c 6c 20 67 72 6f 77 20  tions will grow 
0b80: 77 69 74 68 6f 75 74 20 62 6f 75 6e 64 20 75 6e  without bound un
0b90: 74 69 6c 20 77 65 0a 2a 2a 20 72 75 6e 20 6f 75  til we.** run ou
0ba0: 74 20 6f 66 20 6d 65 6d 6f 72 79 2e 20 20 55 73  t of memory.  Us
0bb0: 65 72 73 20 6f 66 20 74 68 69 73 20 74 65 63 68  ers of this tech
0bc0: 6e 69 71 75 65 20 6d 61 79 20 77 61 6e 74 20 74  nique may want t
0bd0: 6f 20 6b 65 65 70 20 74 72 61 63 6b 20 6f 66 0a  o keep track of.
0be0: 2a 2a 20 74 68 65 20 71 75 61 6e 74 69 74 79 20  ** the quantity 
0bf0: 6f 66 20 70 65 6e 64 69 6e 67 20 77 72 69 74 65  of pending write
0c00: 73 20 61 6e 64 20 73 74 6f 70 20 61 63 63 65 70  s and stop accep
0c10: 74 69 6e 67 20 6e 65 77 20 77 72 69 74 65 20 72  ting new write r
0c20: 65 71 75 65 73 74 73 0a 2a 2a 20 77 68 65 6e 20  equests.** when 
0c30: 74 68 65 20 62 75 66 66 65 72 20 67 65 74 73 20  the buffer gets 
0c40: 74 6f 20 62 65 20 74 6f 6f 20 62 69 67 2e 0a 2a  to be too big..*
0c50: 2f 0a 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c  /..#include "sql
0c60: 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75  iteInt.h".#inclu
0c70: 64 65 20 3c 74 63 6c 2e 68 3e 0a 0a 2f 2a 0a 2a  de <tcl.h>../*.*
0c80: 2a 20 54 68 69 73 20 74 65 73 74 20 75 73 65 73  * This test uses
0c90: 20 70 74 68 72 65 61 64 73 20 61 6e 64 20 68 65   pthreads and he
0ca0: 6e 63 65 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 6f  nce only works o
0cb0: 6e 20 75 6e 69 78 20 61 6e 64 20 77 69 74 68 0a  n unix and with.
0cc0: 2a 2a 20 61 20 74 68 72 65 61 64 73 61 66 65 20  ** a threadsafe 
0cd0: 62 75 69 6c 64 20 6f 66 20 53 51 4c 69 74 65 2e  build of SQLite.
0ce0: 0a 2a 2f 0a 23 69 66 20 4f 53 5f 55 4e 49 58 20  .*/.#if OS_UNIX 
0cf0: 26 26 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44  && SQLITE_THREAD
0d00: 53 41 46 45 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  SAFE../*.** This
0d10: 20 64 65 6d 6f 20 75 73 65 73 20 70 74 68 72 65   demo uses pthre
0d20: 61 64 73 2e 20 20 49 66 20 79 6f 75 20 64 6f 20  ads.  If you do 
0d30: 6e 6f 74 20 68 61 76 65 20 61 20 70 74 68 72 65  not have a pthre
0d40: 61 64 73 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  ads implementati
0d50: 6f 6e 0a 2a 2a 20 66 6f 72 20 79 6f 75 72 20 6f  on.** for your o
0d60: 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 2c  perating system,
0d70: 20 79 6f 75 20 77 69 6c 6c 20 6e 65 65 64 20 74   you will need t
0d80: 6f 20 72 65 63 6f 64 65 20 74 68 65 20 74 68 72  o recode the thr
0d90: 65 61 64 69 6e 67 20 0a 2a 2a 20 6c 6f 67 69 63  eading .** logic
0da0: 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 3c 70  ..*/.#include <p
0db0: 74 68 72 65 61 64 2e 68 3e 0a 23 69 6e 63 6c 75  thread.h>.#inclu
0dc0: 64 65 20 3c 73 63 68 65 64 2e 68 3e 0a 0a 2f 2a  de <sched.h>../*
0dd0: 20 55 73 65 66 75 6c 20 6d 61 63 72 6f 73 20 75   Useful macros u
0de0: 73 65 64 20 69 6e 20 73 65 76 65 72 61 6c 20 70  sed in several p
0df0: 6c 61 63 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65  laces */.#define
0e00: 20 4d 49 4e 28 78 2c 79 29 20 28 28 78 29 3c 28   MIN(x,y) ((x)<(
0e10: 79 29 3f 28 78 29 3a 28 79 29 29 0a 23 64 65 66  y)?(x):(y)).#def
0e20: 69 6e 65 20 4d 41 58 28 78 2c 79 29 20 28 28 78  ine MAX(x,y) ((x
0e30: 29 3e 28 79 29 3f 28 78 29 3a 28 79 29 29 0a 0a  )>(y)?(x):(y))..
0e40: 2f 2a 20 46 6f 72 77 61 72 64 20 72 65 66 65 72  /* Forward refer
0e50: 65 6e 63 65 73 20 2a 2f 0a 74 79 70 65 64 65 66  ences */.typedef
0e60: 20 73 74 72 75 63 74 20 41 73 79 6e 63 57 72 69   struct AsyncWri
0e70: 74 65 20 41 73 79 6e 63 57 72 69 74 65 3b 0a 74  te AsyncWrite;.t
0e80: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 41 73  ypedef struct As
0e90: 79 6e 63 46 69 6c 65 20 41 73 79 6e 63 46 69 6c  yncFile AsyncFil
0ea0: 65 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63  e;.typedef struc
0eb0: 74 20 41 73 79 6e 63 46 69 6c 65 44 61 74 61 20  t AsyncFileData 
0ec0: 41 73 79 6e 63 46 69 6c 65 44 61 74 61 3b 0a 0a  AsyncFileData;..
0ed0: 2f 2a 20 45 6e 61 62 6c 65 20 66 6f 72 20 64 65  /* Enable for de
0ee0: 62 75 67 67 69 6e 67 20 2a 2f 0a 73 74 61 74 69  bugging */.stati
0ef0: 63 20 69 6e 74 20 73 71 6c 69 74 65 33 61 73 79  c int sqlite3asy
0f00: 6e 63 5f 74 72 61 63 65 20 3d 20 30 3b 0a 23 20  nc_trace = 0;.# 
0f10: 64 65 66 69 6e 65 20 41 53 59 4e 43 5f 54 52 41  define ASYNC_TRA
0f20: 43 45 28 58 29 20 69 66 28 20 73 71 6c 69 74 65  CE(X) if( sqlite
0f30: 33 61 73 79 6e 63 5f 74 72 61 63 65 20 29 20 61  3async_trace ) a
0f40: 73 79 6e 63 54 72 61 63 65 20 58 0a 73 74 61 74  syncTrace X.stat
0f50: 69 63 20 76 6f 69 64 20 61 73 79 6e 63 54 72 61  ic void asyncTra
0f60: 63 65 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  ce(const char *z
0f70: 46 6f 72 6d 61 74 2c 20 2e 2e 2e 29 7b 0a 20 20  Format, ...){.  
0f80: 63 68 61 72 20 2a 7a 3b 0a 20 20 76 61 5f 6c 69  char *z;.  va_li
0f90: 73 74 20 61 70 3b 0a 20 20 76 61 5f 73 74 61 72  st ap;.  va_star
0fa0: 74 28 61 70 2c 20 7a 46 6f 72 6d 61 74 29 3b 0a  t(ap, zFormat);.
0fb0: 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f 76 6d    z = sqlite3_vm
0fc0: 70 72 69 6e 74 66 28 7a 46 6f 72 6d 61 74 2c 20  printf(zFormat, 
0fd0: 61 70 29 3b 0a 20 20 76 61 5f 65 6e 64 28 61 70  ap);.  va_end(ap
0fe0: 29 3b 0a 20 20 66 70 72 69 6e 74 66 28 73 74 64  );.  fprintf(std
0ff0: 65 72 72 2c 20 22 5b 25 64 5d 20 25 73 22 2c 20  err, "[%d] %s", 
1000: 28 69 6e 74 29 70 74 68 72 65 61 64 5f 73 65 6c  (int)pthread_sel
1010: 66 28 29 2c 20 7a 29 3b 0a 20 20 73 71 6c 69 74  f(), z);.  sqlit
1020: 65 33 5f 66 72 65 65 28 7a 29 3b 0a 7d 0a 0a 2f  e3_free(z);.}../
1030: 2a 0a 2a 2a 20 54 48 52 45 41 44 20 53 41 46 45  *.** THREAD SAFE
1040: 54 59 20 4e 4f 54 45 53 0a 2a 2a 0a 2a 2a 20 42  TY NOTES.**.** B
1050: 61 73 69 63 20 72 75 6c 65 73 3a 0a 2a 2a 0a 2a  asic rules:.**.*
1060: 2a 20 20 20 20 20 2a 20 42 6f 74 68 20 72 65 61  *     * Both rea
1070: 64 20 61 6e 64 20 77 72 69 74 65 20 61 63 63 65  d and write acce
1080: 73 73 20 74 6f 20 74 68 65 20 67 6c 6f 62 61 6c  ss to the global
1090: 20 77 72 69 74 65 2d 6f 70 20 71 75 65 75 65 20   write-op queue 
10a0: 6d 75 73 74 20 62 65 20 0a 2a 2a 20 20 20 20 20  must be .**     
10b0: 20 20 70 72 6f 74 65 63 74 65 64 20 62 79 20 74    protected by t
10c0: 68 65 20 61 73 79 6e 63 2e 71 75 65 75 65 4d 75  he async.queueMu
10d0: 74 65 78 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 2a  tex..**.**     *
10e0: 20 54 68 65 20 66 69 6c 65 20 68 61 6e 64 6c 65   The file handle
10f0: 73 20 66 72 6f 6d 20 74 68 65 20 75 6e 64 65 72  s from the under
1100: 6c 79 69 6e 67 20 73 79 73 74 65 6d 20 61 72 65  lying system are
1110: 20 61 73 73 75 6d 65 64 20 6e 6f 74 20 74 6f 20   assumed not to 
1120: 0a 2a 2a 20 20 20 20 20 20 20 62 65 20 74 68 72  .**       be thr
1130: 65 61 64 20 73 61 66 65 2e 0a 2a 2a 0a 2a 2a 20  ead safe..**.** 
1140: 20 20 20 20 2a 20 53 65 65 20 74 68 65 20 6c 61      * See the la
1150: 73 74 20 74 77 6f 20 70 61 72 61 67 72 61 70 68  st two paragraph
1160: 73 20 75 6e 64 65 72 20 22 54 68 65 20 57 72 69  s under "The Wri
1170: 74 65 72 20 54 68 72 65 61 64 22 20 66 6f 72 0a  ter Thread" for.
1180: 2a 2a 20 20 20 20 20 20 20 61 6e 20 61 73 73 75  **       an assu
1190: 6d 70 74 69 6f 6e 20 74 6f 20 64 6f 20 77 69 74  mption to do wit
11a0: 68 20 66 69 6c 65 2d 68 61 6e 64 6c 65 20 73 79  h file-handle sy
11b0: 6e 63 68 72 6f 6e 69 7a 61 74 69 6f 6e 20 62 79  nchronization by
11c0: 20 74 68 65 20 4f 73 2e 0a 2a 2a 0a 2a 2a 20 46   the Os..**.** F
11d0: 69 6c 65 20 73 79 73 74 65 6d 20 6f 70 65 72 61  ile system opera
11e0: 74 69 6f 6e 73 20 28 69 6e 76 6f 6b 65 64 20 62  tions (invoked b
11f0: 79 20 53 51 4c 69 74 65 20 74 68 72 65 61 64 29  y SQLite thread)
1200: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 78 4f 70 65  :.**.**     xOpe
1210: 6e 58 58 58 20 28 74 68 72 65 65 20 76 65 72 73  nXXX (three vers
1220: 69 6f 6e 73 29 0a 2a 2a 20 20 20 20 20 78 44 65  ions).**     xDe
1230: 6c 65 74 65 0a 2a 2a 20 20 20 20 20 78 46 69 6c  lete.**     xFil
1240: 65 45 78 69 73 74 73 0a 2a 2a 20 20 20 20 20 78  eExists.**     x
1250: 53 79 6e 63 44 69 72 65 63 74 6f 72 79 0a 2a 2a  SyncDirectory.**
1260: 0a 2a 2a 20 46 69 6c 65 20 68 61 6e 64 6c 65 20  .** File handle 
1270: 6f 70 65 72 61 74 69 6f 6e 73 20 28 69 6e 76 6f  operations (invo
1280: 6b 65 64 20 62 79 20 53 51 4c 69 74 65 20 74 68  ked by SQLite th
1290: 72 65 61 64 29 3a 0a 2a 2a 0a 2a 2a 20 20 20 20  read):.**.**    
12a0: 20 20 20 20 20 61 73 79 6e 63 57 72 69 74 65 2c       asyncWrite,
12b0: 20 61 73 79 6e 63 43 6c 6f 73 65 2c 20 61 73 79   asyncClose, asy
12c0: 6e 63 54 72 75 6e 63 61 74 65 2c 20 61 73 79 6e  ncTruncate, asyn
12d0: 63 53 79 6e 63 2c 20 0a 2a 2a 20 20 20 20 20 20  cSync, .**      
12e0: 20 20 20 61 73 79 6e 63 53 65 74 46 75 6c 6c 53     asyncSetFullS
12f0: 79 6e 63 2c 20 61 73 79 6e 63 4f 70 65 6e 44 69  ync, asyncOpenDi
1300: 72 65 63 74 6f 72 79 2e 0a 2a 2a 20 20 20 20 0a  rectory..**    .
1310: 2a 2a 20 20 20 20 20 54 68 65 20 6f 70 65 72 61  **     The opera
1320: 74 69 6f 6e 73 20 61 62 6f 76 65 20 61 64 64 20  tions above add 
1330: 61 6e 20 65 6e 74 72 79 20 74 6f 20 74 68 65 20  an entry to the 
1340: 67 6c 6f 62 61 6c 20 77 72 69 74 65 2d 6f 70 20  global write-op 
1350: 6c 69 73 74 2e 20 54 68 65 79 0a 2a 2a 20 20 20  list. They.**   
1360: 20 20 70 72 65 70 61 72 65 20 74 68 65 20 65 6e    prepare the en
1370: 74 72 79 2c 20 61 63 71 75 69 72 65 20 74 68 65  try, acquire the
1380: 20 61 73 79 6e 63 2e 71 75 65 75 65 4d 75 74 65   async.queueMute
1390: 78 20 6d 6f 6d 65 6e 74 61 72 69 6c 79 20 77 68  x momentarily wh
13a0: 69 6c 65 0a 2a 2a 20 20 20 20 20 6c 69 73 74 20  ile.**     list 
13b0: 70 6f 69 6e 74 65 72 73 20 61 72 65 20 20 6d 61  pointers are  ma
13c0: 6e 69 70 75 6c 61 74 65 64 20 74 6f 20 69 6e 73  nipulated to ins
13d0: 65 72 74 20 74 68 65 20 6e 65 77 20 65 6e 74 72  ert the new entr
13e0: 79 2c 20 74 68 65 6e 20 72 65 6c 65 61 73 65 0a  y, then release.
13f0: 2a 2a 20 20 20 20 20 74 68 65 20 6d 75 74 65 78  **     the mutex
1400: 20 61 6e 64 20 73 69 67 6e 61 6c 20 74 68 65 20   and signal the 
1410: 77 72 69 74 65 72 20 74 68 72 65 61 64 20 74 6f  writer thread to
1420: 20 77 61 6b 65 20 75 70 20 69 6e 20 63 61 73 65   wake up in case
1430: 20 69 74 20 68 61 70 70 65 6e 73 0a 2a 2a 20 20   it happens.**  
1440: 20 20 20 74 6f 20 62 65 20 61 73 6c 65 65 70 2e     to be asleep.
1450: 0a 2a 2a 0a 2a 2a 20 20 20 20 0a 2a 2a 20 20 20  .**.**    .**   
1460: 20 20 20 20 20 20 61 73 79 6e 63 52 65 61 64 2c        asyncRead,
1470: 20 61 73 79 6e 63 46 69 6c 65 53 69 7a 65 2e 0a   asyncFileSize..
1480: 2a 2a 0a 2a 2a 20 20 20 20 20 52 65 61 64 20 6f  **.**     Read o
1490: 70 65 72 61 74 69 6f 6e 73 2e 20 42 6f 74 68 20  perations. Both 
14a0: 6f 66 20 74 68 65 73 65 20 72 65 61 64 20 66 72  of these read fr
14b0: 6f 6d 20 62 6f 74 68 20 74 68 65 20 75 6e 64 65  om both the unde
14c0: 72 6c 79 69 6e 67 20 66 69 6c 65 0a 2a 2a 20 20  rlying file.**  
14d0: 20 20 20 66 69 72 73 74 20 74 68 65 6e 20 61 64     first then ad
14e0: 6a 75 73 74 20 74 68 65 69 72 20 72 65 73 75 6c  just their resul
14f0: 74 20 62 61 73 65 64 20 6f 6e 20 70 65 6e 64 69  t based on pendi
1500: 6e 67 20 77 72 69 74 65 73 20 69 6e 20 74 68 65  ng writes in the
1510: 20 0a 2a 2a 20 20 20 20 20 77 72 69 74 65 2d 6f   .**     write-o
1520: 70 20 71 75 65 75 65 2e 20 20 20 53 6f 20 61 73  p queue.   So as
1530: 79 6e 63 2e 71 75 65 75 65 4d 75 74 65 78 20 69  ync.queueMutex i
1540: 73 20 68 65 6c 64 20 66 6f 72 20 74 68 65 20 64  s held for the d
1550: 75 72 61 74 69 6f 6e 0a 2a 2a 20 20 20 20 20 6f  uration.**     o
1560: 66 20 74 68 65 73 65 20 6f 70 65 72 61 74 69 6f  f these operatio
1570: 6e 73 20 74 6f 20 70 72 65 76 65 6e 74 20 6f 74  ns to prevent ot
1580: 68 65 72 20 74 68 72 65 61 64 73 20 66 72 6f 6d  her threads from
1590: 20 63 68 61 6e 67 69 6e 67 20 74 68 65 0a 2a 2a   changing the.**
15a0: 20 20 20 20 20 71 75 65 75 65 20 69 6e 20 6d 69       queue in mi
15b0: 64 20 6f 70 65 72 61 74 69 6f 6e 2e 0a 2a 2a 20  d operation..** 
15c0: 20 20 20 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20     .**.**       
15d0: 20 20 61 73 79 6e 63 4c 6f 63 6b 2c 20 61 73 79    asyncLock, asy
15e0: 6e 63 55 6e 6c 6f 63 6b 2c 20 61 73 79 6e 63 4c  ncUnlock, asyncL
15f0: 6f 63 6b 53 74 61 74 65 2c 20 61 73 79 6e 63 43  ockState, asyncC
1600: 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b  heckReservedLock
1610: 0a 2a 2a 20 20 20 20 0a 2a 2a 20 20 20 20 20 54  .**    .**     T
1620: 68 65 73 65 20 70 72 69 6d 69 74 69 76 65 73 20  hese primitives 
1630: 69 6d 70 6c 65 6d 65 6e 74 20 69 6e 2d 70 72 6f  implement in-pro
1640: 63 65 73 73 20 6c 6f 63 6b 69 6e 67 20 75 73 69  cess locking usi
1650: 6e 67 20 61 20 68 61 73 68 20 74 61 62 6c 65 0a  ng a hash table.
1660: 2a 2a 20 20 20 20 20 6f 6e 20 74 68 65 20 66 69  **     on the fi
1670: 6c 65 20 6e 61 6d 65 2e 20 20 46 69 6c 65 73 20  le name.  Files 
1680: 61 72 65 20 6c 6f 63 6b 65 64 20 63 6f 72 72 65  are locked corre
1690: 63 74 6c 79 20 66 6f 72 20 63 6f 6e 6e 65 63 74  ctly for connect
16a0: 69 6f 6e 73 20 63 6f 6d 69 6e 67 0a 2a 2a 20 20  ions coming.**  
16b0: 20 20 20 66 72 6f 6d 20 74 68 65 20 73 61 6d 65     from the same
16c0: 20 70 72 6f 63 65 73 73 2e 20 20 42 75 74 20 6f   process.  But o
16d0: 74 68 65 72 20 70 72 6f 63 65 73 73 65 73 20 63  ther processes c
16e0: 61 6e 6e 6f 74 20 73 65 65 20 74 68 65 73 65 20  annot see these 
16f0: 6c 6f 63 6b 73 0a 2a 2a 20 20 20 20 20 61 6e 64  locks.**     and
1700: 20 77 69 6c 6c 20 74 68 65 72 65 66 6f 72 65 20   will therefore 
1710: 6e 6f 74 20 68 6f 6e 6f 72 20 74 68 65 6d 2e 0a  not honor them..
1720: 2a 2a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 20  **.**.**        
1730: 20 61 73 79 6e 63 46 69 6c 65 48 61 6e 64 6c 65   asyncFileHandle
1740: 2e 0a 2a 2a 20 20 20 20 0a 2a 2a 20 20 20 20 20  ..**    .**     
1750: 54 68 65 20 73 71 6c 69 74 65 33 4f 73 46 69 6c  The sqlite3OsFil
1760: 65 48 61 6e 64 6c 65 28 29 20 66 75 6e 63 74 69  eHandle() functi
1770: 6f 6e 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20  on is currently 
1780: 6f 6e 6c 79 20 75 73 65 64 20 77 68 65 6e 20 0a  only used when .
1790: 2a 2a 20 20 20 20 20 64 65 62 75 67 67 69 6e 67  **     debugging
17a0: 20 74 68 65 20 70 61 67 65 72 20 6d 6f 64 75 6c   the pager modul
17b0: 65 2e 20 55 6e 6c 65 73 73 20 73 71 6c 69 74 65  e. Unless sqlite
17c0: 33 4f 73 43 6c 6f 73 65 28 29 20 69 73 20 63 61  3OsClose() is ca
17d0: 6c 6c 65 64 20 6f 6e 20 74 68 65 0a 2a 2a 20 20  lled on the.**  
17e0: 20 20 20 66 69 6c 65 20 28 73 68 6f 75 6c 64 6e     file (shouldn
17f0: 27 74 20 62 65 20 70 6f 73 73 69 62 6c 65 20 66  't be possible f
1800: 6f 72 20 6f 74 68 65 72 20 72 65 61 73 6f 6e 73  or other reasons
1810: 29 2c 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e  ), the underlyin
1820: 67 20 0a 2a 2a 20 20 20 20 20 69 6d 70 6c 65 6d  g .**     implem
1830: 65 6e 74 61 74 69 6f 6e 73 20 61 72 65 20 73 61  entations are sa
1840: 66 65 20 74 6f 20 63 61 6c 6c 20 77 69 74 68 6f  fe to call witho
1850: 75 74 20 67 72 61 62 62 69 6e 67 20 61 6e 79 20  ut grabbing any 
1860: 6d 75 74 65 78 2e 20 53 6f 20 77 65 20 6a 75 73  mutex. So we jus
1870: 74 0a 2a 2a 20 20 20 20 20 67 6f 20 61 68 65 61  t.**     go ahea
1880: 64 20 61 6e 64 20 63 61 6c 6c 20 69 74 20 6e 6f  d and call it no
1890: 20 6d 61 74 74 65 72 20 77 68 61 74 20 61 6e 79   matter what any
18a0: 20 6f 74 68 65 72 20 74 68 72 65 61 64 73 20 61   other threads a
18b0: 72 65 20 64 6f 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20  re doing..**.** 
18c0: 20 20 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 61     .**         a
18d0: 73 79 6e 63 53 65 65 6b 2e 0a 2a 2a 0a 2a 2a 20  syncSeek..**.** 
18e0: 20 20 20 20 43 61 6c 6c 69 6e 67 20 74 68 69 73      Calling this
18f0: 20 6d 65 74 68 6f 64 20 6a 75 73 74 20 6d 61 6e   method just man
1900: 69 70 75 6c 61 74 65 73 20 74 68 65 20 41 73 79  ipulates the Asy
1910: 6e 63 46 69 6c 65 2e 69 4f 66 66 73 65 74 20 76  ncFile.iOffset v
1920: 61 72 69 61 62 6c 65 2e 20 0a 2a 2a 20 20 20 20  ariable. .**    
1930: 20 53 69 6e 63 65 20 74 68 69 73 20 76 61 72 69   Since this vari
1940: 61 62 6c 65 20 69 73 20 6e 65 76 65 72 20 61 63  able is never ac
1950: 63 65 73 73 65 64 20 62 79 20 77 72 69 74 65 72  cessed by writer
1960: 20 74 68 72 65 61 64 2c 20 74 68 69 73 0a 2a 2a   thread, this.**
1970: 20 20 20 20 20 66 75 6e 63 74 69 6f 6e 20 64 6f       function do
1980: 65 73 20 6e 6f 74 20 72 65 71 75 69 72 65 20 74  es not require t
1990: 68 65 20 6d 75 74 65 78 2e 20 20 41 63 74 75 61  he mutex.  Actua
19a0: 6c 20 63 61 6c 6c 73 20 74 6f 20 4f 73 53 65 65  l calls to OsSee
19b0: 6b 28 29 20 74 61 6b 65 20 0a 2a 2a 20 20 20 20  k() take .**    
19c0: 20 70 6c 61 63 65 20 6a 75 73 74 20 62 65 66 6f   place just befo
19d0: 72 65 20 4f 73 57 72 69 74 65 28 29 20 6f 72 20  re OsWrite() or 
19e0: 4f 73 52 65 61 64 28 29 2c 20 77 68 69 63 68 20  OsRead(), which 
19f0: 61 72 65 20 61 6c 77 61 79 73 20 70 72 6f 74 65  are always prote
1a00: 63 74 65 64 20 62 79 20 0a 2a 2a 20 20 20 20 20  cted by .**     
1a10: 74 68 65 20 6d 75 74 65 78 2e 0a 2a 2a 0a 2a 2a  the mutex..**.**
1a20: 20 54 68 65 20 77 72 69 74 65 72 20 74 68 72 65   The writer thre
1a30: 61 64 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 54 68  ad:.**.**     Th
1a40: 65 20 61 73 79 6e 63 2e 77 72 69 74 65 72 4d 75  e async.writerMu
1a50: 74 65 78 20 69 73 20 75 73 65 64 20 74 6f 20 6d  tex is used to m
1a60: 61 6b 65 20 73 75 72 65 20 6f 6e 6c 79 20 74 68  ake sure only th
1a70: 65 72 65 20 69 73 20 6f 6e 6c 79 0a 2a 2a 20 20  ere is only.**  
1a80: 20 20 20 61 20 73 69 6e 67 6c 65 20 77 72 69 74     a single writ
1a90: 65 72 20 74 68 72 65 61 64 20 72 75 6e 6e 69 6e  er thread runnin
1aa0: 67 20 61 74 20 61 20 74 69 6d 65 2e 0a 2a 2a 0a  g at a time..**.
1ab0: 2a 2a 20 20 20 20 20 49 6e 73 69 64 65 20 74 68  **     Inside th
1ac0: 65 20 77 72 69 74 65 72 20 74 68 72 65 61 64 20  e writer thread 
1ad0: 69 73 20 61 20 6c 6f 6f 70 20 74 68 61 74 20 77  is a loop that w
1ae0: 6f 72 6b 73 20 6c 69 6b 65 20 74 68 69 73 3a 0a  orks like this:.
1af0: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 20 20 57 48  **.**         WH
1b00: 49 4c 45 20 28 77 72 69 74 65 2d 6f 70 20 6c 69  ILE (write-op li
1b10: 73 74 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 29  st is not empty)
1b20: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20  .**             
1b30: 44 6f 20 49 4f 20 6f 70 65 72 61 74 69 6f 6e 20  Do IO operation 
1b40: 61 74 20 68 65 61 64 20 6f 66 20 77 72 69 74 65  at head of write
1b50: 2d 6f 70 20 6c 69 73 74 0a 2a 2a 20 20 20 20 20  -op list.**     
1b60: 20 20 20 20 20 20 20 20 52 65 6d 6f 76 65 20 65          Remove e
1b70: 6e 74 72 79 20 66 72 6f 6d 20 68 65 61 64 20 6f  ntry from head o
1b80: 66 20 77 72 69 74 65 2d 6f 70 20 6c 69 73 74 0a  f write-op list.
1b90: 2a 2a 20 20 20 20 20 20 20 20 20 45 4e 44 20 57  **         END W
1ba0: 48 49 4c 45 0a 2a 2a 0a 2a 2a 20 20 20 20 20 54  HILE.**.**     T
1bb0: 68 65 20 61 73 79 6e 63 2e 71 75 65 75 65 4d 75  he async.queueMu
1bc0: 74 65 78 20 69 73 20 61 6c 77 61 79 73 20 68 65  tex is always he
1bd0: 6c 64 20 64 75 72 69 6e 67 20 74 68 65 20 3c 77  ld during the <w
1be0: 72 69 74 65 2d 6f 70 20 6c 69 73 74 20 69 73 20  rite-op list is 
1bf0: 0a 2a 2a 20 20 20 20 20 6e 6f 74 20 65 6d 70 74  .**     not empt
1c00: 79 3e 20 74 65 73 74 2c 20 61 6e 64 20 77 68 65  y> test, and whe
1c10: 6e 20 74 68 65 20 65 6e 74 72 79 20 69 73 20 72  n the entry is r
1c20: 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20  emoved from the 
1c30: 68 65 61 64 0a 2a 2a 20 20 20 20 20 6f 66 20 74  head.**     of t
1c40: 68 65 20 77 72 69 74 65 2d 6f 70 20 6c 69 73 74  he write-op list
1c50: 2e 20 53 6f 6d 65 74 69 6d 65 73 20 69 74 20 69  . Sometimes it i
1c60: 73 20 68 65 6c 64 20 66 6f 72 20 74 68 65 20 69  s held for the i
1c70: 6e 74 65 72 69 6d 0a 2a 2a 20 20 20 20 20 70 65  nterim.**     pe
1c80: 72 69 6f 64 20 28 77 68 69 6c 65 20 74 68 65 20  riod (while the 
1c90: 49 4f 20 69 73 20 70 65 72 66 6f 72 6d 65 64 29  IO is performed)
1ca0: 2c 20 61 6e 64 20 73 6f 6d 65 74 69 6d 65 73 20  , and sometimes 
1cb0: 69 74 20 69 73 0a 2a 2a 20 20 20 20 20 72 65 6c  it is.**     rel
1cc0: 69 6e 71 75 69 73 68 65 64 2e 20 49 74 20 69 73  inquished. It is
1cd0: 20 72 65 6c 69 6e 71 75 69 73 68 65 64 20 69 66   relinquished if
1ce0: 20 28 61 29 20 74 68 65 20 49 4f 20 6f 70 20 69   (a) the IO op i
1cf0: 73 20 61 6e 0a 2a 2a 20 20 20 20 20 41 53 59 4e  s an.**     ASYN
1d00: 43 5f 43 4c 4f 53 45 20 6f 72 20 28 62 29 20 77  C_CLOSE or (b) w
1d10: 68 65 6e 20 74 68 65 20 66 69 6c 65 20 68 61 6e  hen the file han
1d20: 64 6c 65 20 77 61 73 20 6f 70 65 6e 65 64 2c 20  dle was opened, 
1d30: 74 77 6f 20 6f 66 0a 2a 2a 20 20 20 20 20 74 68  two of.**     th
1d40: 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 73 79 73  e underlying sys
1d50: 74 65 6d 73 20 68 61 6e 64 6c 65 73 20 77 65 72  tems handles wer
1d60: 65 20 6f 70 65 6e 65 64 20 6f 6e 20 74 68 65 20  e opened on the 
1d70: 73 61 6d 65 0a 2a 2a 20 20 20 20 20 66 69 6c 65  same.**     file
1d80: 2d 73 79 73 74 65 6d 20 65 6e 74 72 79 2e 0a 2a  -system entry..*
1d90: 2a 0a 2a 2a 20 20 20 20 20 49 66 20 63 6f 6e 64  *.**     If cond
1da0: 69 74 69 6f 6e 20 28 62 29 20 61 62 6f 76 65 20  ition (b) above 
1db0: 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 6f 6e  is true, then on
1dc0: 65 20 66 69 6c 65 2d 68 61 6e 64 6c 65 20 0a 2a  e file-handle .*
1dd0: 2a 20 20 20 20 20 28 41 73 79 6e 63 46 69 6c 65  *     (AsyncFile
1de0: 2e 70 42 61 73 65 52 65 61 64 29 20 69 73 20 75  .pBaseRead) is u
1df0: 73 65 64 20 65 78 63 6c 75 73 69 76 65 6c 79 20  sed exclusively 
1e00: 62 79 20 73 71 6c 69 74 65 20 74 68 72 65 61 64  by sqlite thread
1e10: 73 20 74 6f 20 72 65 61 64 20 74 68 65 0a 2a 2a  s to read the.**
1e20: 20 20 20 20 20 66 69 6c 65 2c 20 74 68 65 20 6f       file, the o
1e30: 74 68 65 72 20 28 41 73 79 6e 63 46 69 6c 65 2e  ther (AsyncFile.
1e40: 70 42 61 73 65 57 72 69 74 65 29 20 62 79 20 73  pBaseWrite) by s
1e50: 71 6c 69 74 65 33 5f 61 73 79 6e 63 5f 66 6c 75  qlite3_async_flu
1e60: 73 68 28 29 20 0a 2a 2a 20 20 20 20 20 74 68 72  sh() .**     thr
1e70: 65 61 64 73 20 74 6f 20 70 65 72 66 6f 72 6d 20  eads to perform 
1e80: 77 72 69 74 65 28 29 20 6f 70 65 72 61 74 69 6f  write() operatio
1e90: 6e 73 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 74  ns. This means t
1ea0: 68 61 74 20 72 65 61 64 20 0a 2a 2a 20 20 20 20  hat read .**    
1eb0: 20 6f 70 65 72 61 74 69 6f 6e 73 20 61 72 65 20   operations are 
1ec0: 6e 6f 74 20 62 6c 6f 63 6b 65 64 20 62 79 20 61  not blocked by a
1ed0: 73 79 6e 63 68 72 6f 6e 6f 75 73 20 77 72 69 74  synchronous writ
1ee0: 65 73 20 28 61 6c 74 68 6f 75 67 68 20 0a 2a 2a  es (although .**
1ef0: 20 20 20 20 20 61 73 79 6e 63 68 72 6f 6e 6f 75       asynchronou
1f00: 73 20 77 72 69 74 65 73 20 6d 61 79 20 73 74 69  s writes may sti
1f10: 6c 6c 20 62 65 20 62 6c 6f 63 6b 65 64 20 62 79  ll be blocked by
1f20: 20 72 65 61 64 73 29 2e 0a 2a 2a 0a 2a 2a 20 20   reads)..**.**  
1f30: 20 20 20 54 68 69 73 20 61 73 73 75 6d 65 73 20     This assumes 
1f40: 74 68 61 74 20 74 68 65 20 4f 53 20 6b 65 65 70  that the OS keep
1f50: 73 20 74 77 6f 20 68 61 6e 64 6c 65 73 20 6f 70  s two handles op
1f60: 65 6e 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 66  en on the same f
1f70: 69 6c 65 0a 2a 2a 20 20 20 20 20 70 72 6f 70 65  ile.**     prope
1f80: 72 6c 79 20 69 6e 20 73 79 6e 63 2e 20 54 68 61  rly in sync. Tha
1f90: 74 20 69 73 2c 20 61 6e 79 20 72 65 61 64 20 6f  t is, any read o
1fa0: 70 65 72 61 74 69 6f 6e 20 74 68 61 74 20 73 74  peration that st
1fb0: 61 72 74 73 20 61 66 74 65 72 20 61 0a 2a 2a 20  arts after a.** 
1fc0: 20 20 20 20 77 72 69 74 65 20 6f 70 65 72 61 74      write operat
1fd0: 69 6f 6e 20 6f 6e 20 74 68 65 20 73 61 6d 65 20  ion on the same 
1fe0: 66 69 6c 65 20 73 79 73 74 65 6d 20 65 6e 74 72  file system entr
1ff0: 79 20 68 61 73 20 63 6f 6d 70 6c 65 74 65 64 20  y has completed 
2000: 72 65 74 75 72 6e 73 0a 2a 2a 20 20 20 20 20 64  returns.**     d
2010: 61 74 61 20 63 6f 6e 73 69 73 74 65 6e 74 20 77  ata consistent w
2020: 69 74 68 20 74 68 65 20 77 72 69 74 65 2e 20 57  ith the write. W
2030: 65 20 61 6c 73 6f 20 61 73 73 75 6d 65 20 74 68  e also assume th
2040: 61 74 20 69 66 20 6f 6e 65 20 74 68 72 65 61 64  at if one thread
2050: 20 0a 2a 2a 20 20 20 20 20 72 65 61 64 73 20 61   .**     reads a
2060: 20 66 69 6c 65 20 77 68 69 6c 65 20 61 6e 6f 74   file while anot
2070: 68 65 72 20 69 73 20 77 72 69 74 69 6e 67 20 69  her is writing i
2080: 74 20 61 6c 6c 20 62 79 74 65 73 20 6f 74 68 65  t all bytes othe
2090: 72 20 74 68 61 6e 20 74 68 65 0a 2a 2a 20 20 20  r than the.**   
20a0: 20 20 6f 6e 65 73 20 61 63 74 75 61 6c 6c 79 20    ones actually 
20b0: 62 65 69 6e 67 20 77 72 69 74 74 65 6e 20 63 6f  being written co
20c0: 6e 74 61 69 6e 20 76 61 6c 69 64 20 64 61 74 61  ntain valid data
20d0: 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 49 66 20 74  ..**.**     If t
20e0: 68 65 20 61 62 6f 76 65 20 61 73 73 75 6d 70 74  he above assumpt
20f0: 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20 74 72 75  ions are not tru
2100: 65 2c 20 73 65 74 20 74 68 65 20 70 72 65 70 72  e, set the prepr
2110: 6f 63 65 73 73 6f 72 20 73 79 6d 62 6f 6c 0a 2a  ocessor symbol.*
2120: 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 41 53 59  *     SQLITE_ASY
2130: 4e 43 5f 54 57 4f 5f 46 49 4c 45 48 41 4e 44 4c  NC_TWO_FILEHANDL
2140: 45 53 20 74 6f 20 30 2e 0a 2a 2f 0a 0a 23 69 66  ES to 0..*/..#if
2150: 6e 64 65 66 20 53 51 4c 49 54 45 5f 41 53 59 4e  ndef SQLITE_ASYN
2160: 43 5f 54 57 4f 5f 46 49 4c 45 48 41 4e 44 4c 45  C_TWO_FILEHANDLE
2170: 53 0a 2f 2a 20 23 64 65 66 69 6e 65 20 53 51 4c  S./* #define SQL
2180: 49 54 45 5f 41 53 59 4e 43 5f 54 57 4f 5f 46 49  ITE_ASYNC_TWO_FI
2190: 4c 45 48 41 4e 44 4c 45 53 20 30 20 2a 2f 0a 23  LEHANDLES 0 */.#
21a0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 53  define SQLITE_AS
21b0: 59 4e 43 5f 54 57 4f 5f 46 49 4c 45 48 41 4e 44  YNC_TWO_FILEHAND
21c0: 4c 45 53 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a  LES 1.#endif../*
21d0: 0a 2a 2a 20 53 74 61 74 65 20 69 6e 66 6f 72 6d  .** State inform
21e0: 61 74 69 6f 6e 20 69 73 20 68 65 6c 64 20 69 6e  ation is held in
21f0: 20 74 68 65 20 73 74 61 74 69 63 20 76 61 72 69   the static vari
2200: 61 62 6c 65 20 22 61 73 79 6e 63 22 20 64 65 66  able "async" def
2210: 69 6e 65 64 0a 2a 2a 20 61 73 20 66 6f 6c 6c 6f  ined.** as follo
2220: 77 73 3a 0a 2a 2f 0a 73 74 61 74 69 63 20 73 74  ws:.*/.static st
2230: 72 75 63 74 20 54 65 73 74 41 73 79 6e 63 53 74  ruct TestAsyncSt
2240: 61 74 69 63 44 61 74 61 20 7b 0a 20 20 70 74 68  aticData {.  pth
2250: 72 65 61 64 5f 6d 75 74 65 78 5f 74 20 71 75 65  read_mutex_t que
2260: 75 65 4d 75 74 65 78 3b 20 20 2f 2a 20 4d 75 74  ueMutex;  /* Mut
2270: 65 78 20 66 6f 72 20 61 63 63 65 73 73 20 74 6f  ex for access to
2280: 20 77 72 69 74 65 20 6f 70 65 72 61 74 69 6f 6e   write operation
2290: 20 71 75 65 75 65 20 2a 2f 0a 20 20 70 74 68 72   queue */.  pthr
22a0: 65 61 64 5f 6d 75 74 65 78 5f 74 20 77 72 69 74  ead_mutex_t writ
22b0: 65 72 4d 75 74 65 78 3b 20 2f 2a 20 50 72 65 76  erMutex; /* Prev
22c0: 65 6e 74 73 20 6d 75 6c 74 69 70 6c 65 20 77 72  ents multiple wr
22d0: 69 74 65 72 20 74 68 72 65 61 64 73 20 2a 2f 0a  iter threads */.
22e0: 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f    pthread_mutex_
22f0: 74 20 6c 6f 63 6b 4d 75 74 65 78 3b 20 20 20 2f  t lockMutex;   /
2300: 2a 20 46 6f 72 20 61 63 63 65 73 73 20 74 6f 20  * For access to 
2310: 61 4c 6f 63 6b 20 68 61 73 68 20 74 61 62 6c 65  aLock hash table
2320: 20 2a 2f 0a 20 20 70 74 68 72 65 61 64 5f 63 6f   */.  pthread_co
2330: 6e 64 5f 74 20 71 75 65 75 65 53 69 67 6e 61 6c  nd_t queueSignal
2340: 3b 20 20 2f 2a 20 46 6f 72 20 77 61 6b 69 6e 67  ;  /* For waking
2350: 20 75 70 20 73 6c 65 65 70 69 6e 67 20 77 72 69   up sleeping wri
2360: 74 65 72 20 74 68 72 65 61 64 20 2a 2f 0a 20 20  ter thread */.  
2370: 70 74 68 72 65 61 64 5f 63 6f 6e 64 5f 74 20 65  pthread_cond_t e
2380: 6d 70 74 79 53 69 67 6e 61 6c 3b 20 20 2f 2a 20  mptySignal;  /* 
2390: 4e 6f 74 69 66 79 20 77 68 65 6e 20 74 68 65 20  Notify when the 
23a0: 77 72 69 74 65 20 71 75 65 75 65 20 69 73 20 65  write queue is e
23b0: 6d 70 74 79 20 2a 2f 0a 20 20 41 73 79 6e 63 57  mpty */.  AsyncW
23c0: 72 69 74 65 20 2a 70 51 75 65 75 65 46 69 72 73  rite *pQueueFirs
23d0: 74 3b 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 77  t;     /* Next w
23e0: 72 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 20 74  rite operation t
23f0: 6f 20 62 65 20 70 72 6f 63 65 73 73 65 64 20 2a  o be processed *
2400: 2f 0a 20 20 41 73 79 6e 63 57 72 69 74 65 20 2a  /.  AsyncWrite *
2410: 70 51 75 65 75 65 4c 61 73 74 3b 20 20 20 20 20  pQueueLast;     
2420: 20 2f 2a 20 4c 61 73 74 20 77 72 69 74 65 20 6f   /* Last write o
2430: 70 65 72 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20  peration on the 
2440: 6c 69 73 74 20 2a 2f 0a 20 20 48 61 73 68 20 61  list */.  Hash a
2450: 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 20 20 20  Lock;           
2460: 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 73 20         /* Files 
2470: 6c 6f 63 6b 65 64 20 2a 2f 0a 20 20 76 6f 6c 61  locked */.  vola
2480: 74 69 6c 65 20 69 6e 74 20 69 6f 44 65 6c 61 79  tile int ioDelay
2490: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
24a0: 20 45 78 74 72 61 20 64 65 6c 61 79 20 62 65 74   Extra delay bet
24b0: 77 65 65 6e 20 77 72 69 74 65 20 6f 70 65 72 61  ween write opera
24c0: 74 69 6f 6e 73 20 2a 2f 0a 20 20 76 6f 6c 61 74  tions */.  volat
24d0: 69 6c 65 20 69 6e 74 20 77 72 69 74 65 72 48 61  ile int writerHa
24e0: 6c 74 57 68 65 6e 49 64 6c 65 3b 20 20 2f 2a 20  ltWhenIdle;  /* 
24f0: 57 72 69 74 65 72 20 74 68 72 65 61 64 20 68 61  Writer thread ha
2500: 6c 74 73 20 77 68 65 6e 20 71 75 65 75 65 20 65  lts when queue e
2510: 6d 70 74 79 20 2a 2f 0a 20 20 76 6f 6c 61 74 69  mpty */.  volati
2520: 6c 65 20 69 6e 74 20 77 72 69 74 65 72 48 61 6c  le int writerHal
2530: 74 4e 6f 77 3b 20 20 20 20 20 20 20 2f 2a 20 57  tNow;       /* W
2540: 72 69 74 65 72 20 74 68 72 65 61 64 20 68 61 6c  riter thread hal
2550: 74 73 20 61 66 74 65 72 20 6e 65 78 74 20 6f 70  ts after next op
2560: 20 2a 2f 0a 20 20 69 6e 74 20 69 6f 45 72 72 6f   */.  int ioErro
2570: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  r;              
2580: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 61 6e     /* True if an
2590: 20 49 4f 20 65 72 72 6f 72 20 68 61 73 20 6f 63   IO error has oc
25a0: 63 75 72 65 64 20 2a 2f 0a 20 20 69 6e 74 20 6e  cured */.  int n
25b0: 46 69 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20  File;           
25c0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
25d0: 72 20 6f 66 20 6f 70 65 6e 20 66 69 6c 65 73 20  r of open files 
25e0: 28 66 72 6f 6d 20 73 71 6c 69 74 65 20 70 6f 76  (from sqlite pov
25f0: 29 20 2a 2f 0a 7d 20 61 73 79 6e 63 20 3d 20 7b  ) */.} async = {
2600: 0a 20 20 50 54 48 52 45 41 44 5f 4d 55 54 45 58  .  PTHREAD_MUTEX
2610: 5f 49 4e 49 54 49 41 4c 49 5a 45 52 2c 0a 20 20  _INITIALIZER,.  
2620: 50 54 48 52 45 41 44 5f 4d 55 54 45 58 5f 49 4e  PTHREAD_MUTEX_IN
2630: 49 54 49 41 4c 49 5a 45 52 2c 0a 20 20 50 54 48  ITIALIZER,.  PTH
2640: 52 45 41 44 5f 4d 55 54 45 58 5f 49 4e 49 54 49  READ_MUTEX_INITI
2650: 41 4c 49 5a 45 52 2c 0a 20 20 50 54 48 52 45 41  ALIZER,.  PTHREA
2660: 44 5f 43 4f 4e 44 5f 49 4e 49 54 49 41 4c 49 5a  D_COND_INITIALIZ
2670: 45 52 2c 0a 20 20 50 54 48 52 45 41 44 5f 43 4f  ER,.  PTHREAD_CO
2680: 4e 44 5f 49 4e 49 54 49 41 4c 49 5a 45 52 2c 0a  ND_INITIALIZER,.
2690: 7d 3b 0a 0a 2f 2a 20 50 6f 73 73 69 62 6c 65 20  };../* Possible 
26a0: 76 61 6c 75 65 73 20 6f 66 20 41 73 79 6e 63 57  values of AsyncW
26b0: 72 69 74 65 2e 6f 70 20 2a 2f 0a 23 64 65 66 69  rite.op */.#defi
26c0: 6e 65 20 41 53 59 4e 43 5f 4e 4f 4f 50 20 20 20  ne ASYNC_NOOP   
26d0: 20 20 20 20 20 20 20 30 0a 23 64 65 66 69 6e 65         0.#define
26e0: 20 41 53 59 4e 43 5f 57 52 49 54 45 20 20 20 20   ASYNC_WRITE    
26f0: 20 20 20 20 20 31 0a 23 64 65 66 69 6e 65 20 41       1.#define A
2700: 53 59 4e 43 5f 53 59 4e 43 20 20 20 20 20 20 20  SYNC_SYNC       
2710: 20 20 20 32 0a 23 64 65 66 69 6e 65 20 41 53 59     2.#define ASY
2720: 4e 43 5f 54 52 55 4e 43 41 54 45 20 20 20 20 20  NC_TRUNCATE     
2730: 20 33 0a 23 64 65 66 69 6e 65 20 41 53 59 4e 43   3.#define ASYNC
2740: 5f 43 4c 4f 53 45 20 20 20 20 20 20 20 20 20 34  _CLOSE         4
2750: 0a 23 64 65 66 69 6e 65 20 41 53 59 4e 43 5f 4f  .#define ASYNC_O
2760: 50 45 4e 44 49 52 45 43 54 4f 52 59 20 35 0a 23  PENDIRECTORY 5.#
2770: 64 65 66 69 6e 65 20 41 53 59 4e 43 5f 53 45 54  define ASYNC_SET
2780: 46 55 4c 4c 53 59 4e 43 20 20 20 36 0a 23 64 65  FULLSYNC   6.#de
2790: 66 69 6e 65 20 41 53 59 4e 43 5f 44 45 4c 45 54  fine ASYNC_DELET
27a0: 45 20 20 20 20 20 20 20 20 37 0a 23 64 65 66 69  E        7.#defi
27b0: 6e 65 20 41 53 59 4e 43 5f 4f 50 45 4e 45 58 43  ne ASYNC_OPENEXC
27c0: 4c 55 53 49 56 45 20 38 0a 23 64 65 66 69 6e 65  LUSIVE 8.#define
27d0: 20 41 53 59 4e 43 5f 53 59 4e 43 44 49 52 45 43   ASYNC_SYNCDIREC
27e0: 54 4f 52 59 20 39 0a 0a 2f 2a 20 4e 61 6d 65 73  TORY 9../* Names
27f0: 20 6f 66 20 6f 70 63 6f 64 65 73 2e 20 20 55 73   of opcodes.  Us
2800: 65 64 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67  ed for debugging
2810: 20 6f 6e 6c 79 2e 0a 2a 2a 20 4d 61 6b 65 20 73   only..** Make s
2820: 75 72 65 20 74 68 65 73 65 20 73 74 61 79 20 69  ure these stay i
2830: 6e 20 73 79 6e 63 20 77 69 74 68 20 74 68 65 20  n sync with the 
2840: 6d 61 63 72 6f 73 20 61 62 6f 76 65 21 0a 2a 2f  macros above!.*/
2850: 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68  .static const ch
2860: 61 72 20 2a 61 7a 4f 70 63 6f 64 65 4e 61 6d 65  ar *azOpcodeName
2870: 5b 5d 20 3d 20 7b 0a 20 20 22 4e 4f 4f 50 22 2c  [] = {.  "NOOP",
2880: 20 22 57 52 49 54 45 22 2c 20 22 53 59 4e 43 22   "WRITE", "SYNC"
2890: 2c 20 22 54 52 55 4e 43 41 54 45 22 2c 20 22 43  , "TRUNCATE", "C
28a0: 4c 4f 53 45 22 2c 0a 20 20 22 4f 50 45 4e 44 49  LOSE",.  "OPENDI
28b0: 52 22 2c 20 22 53 45 54 46 55 4c 4c 53 59 4e 43  R", "SETFULLSYNC
28c0: 22 2c 20 22 44 45 4c 45 54 45 22 2c 20 22 4f 50  ", "DELETE", "OP
28d0: 45 4e 45 58 22 2c 20 22 53 59 4e 43 44 49 52 22  ENEX", "SYNCDIR"
28e0: 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 45 6e 74 72  ,.};../*.** Entr
28f0: 69 65 73 20 6f 6e 20 74 68 65 20 77 72 69 74 65  ies on the write
2900: 2d 6f 70 20 71 75 65 75 65 20 61 72 65 20 69 6e  -op queue are in
2910: 73 74 61 6e 63 65 73 20 6f 66 20 74 68 65 20 41  stances of the A
2920: 73 79 6e 63 57 72 69 74 65 0a 2a 2a 20 73 74 72  syncWrite.** str
2930: 75 63 74 75 72 65 2c 20 64 65 66 69 6e 65 64 20  ucture, defined 
2940: 68 65 72 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  here..**.** The 
2950: 69 6e 74 65 72 70 72 65 74 61 74 69 6f 6e 20 6f  interpretation o
2960: 66 20 74 68 65 20 69 4f 66 66 73 65 74 20 61 6e  f the iOffset an
2970: 64 20 6e 42 79 74 65 20 76 61 72 69 61 62 6c 65  d nByte variable
2980: 73 20 76 61 72 69 65 73 20 64 65 70 65 6e 64 69  s varies dependi
2990: 6e 67 20 0a 2a 2a 20 6f 6e 20 74 68 65 20 76 61  ng .** on the va
29a0: 6c 75 65 20 6f 66 20 41 73 79 6e 63 57 72 69 74  lue of AsyncWrit
29b0: 65 2e 6f 70 3a 0a 2a 2a 0a 2a 2a 20 41 53 59 4e  e.op:.**.** ASYN
29c0: 43 5f 57 52 49 54 45 3a 0a 2a 2a 20 20 20 20 20  C_WRITE:.**     
29d0: 69 4f 66 66 73 65 74 20 2d 3e 20 4f 66 66 73 65  iOffset -> Offse
29e0: 74 20 69 6e 20 66 69 6c 65 20 74 6f 20 77 72 69  t in file to wri
29f0: 74 65 20 74 6f 2e 0a 2a 2a 20 20 20 20 20 6e 42  te to..**     nB
2a00: 79 74 65 20 20 20 2d 3e 20 4e 75 6d 62 65 72 20  yte   -> Number 
2a10: 6f 66 20 62 79 74 65 73 20 6f 66 20 64 61 74 61  of bytes of data
2a20: 20 74 6f 20 77 72 69 74 65 20 28 70 6f 69 6e 74   to write (point
2a30: 65 64 20 74 6f 20 62 79 20 7a 42 75 66 29 2e 0a  ed to by zBuf)..
2a40: 2a 2a 0a 2a 2a 20 41 53 59 4e 43 5f 53 59 4e 43  **.** ASYNC_SYNC
2a50: 3a 0a 2a 2a 20 20 20 20 20 6e 42 79 74 65 20 20  :.**     nByte  
2a60: 20 2d 3e 20 66 6c 61 67 73 20 74 6f 20 70 61 73   -> flags to pas
2a70: 73 20 74 6f 20 73 71 6c 69 74 65 33 4f 73 53 79  s to sqlite3OsSy
2a80: 6e 63 28 29 2e 0a 2a 2a 0a 2a 2a 20 41 53 59 4e  nc()..**.** ASYN
2a90: 43 5f 54 52 55 4e 43 41 54 45 3a 0a 2a 2a 20 20  C_TRUNCATE:.**  
2aa0: 20 20 20 69 4f 66 66 73 65 74 20 2d 3e 20 53 69     iOffset -> Si
2ab0: 7a 65 20 74 6f 20 74 72 75 6e 63 61 74 65 20 66  ze to truncate f
2ac0: 69 6c 65 20 74 6f 2e 0a 2a 2a 20 20 20 20 20 6e  ile to..**     n
2ad0: 42 79 74 65 20 20 20 2d 3e 20 55 6e 75 73 65 64  Byte   -> Unused
2ae0: 2e 0a 2a 2a 0a 2a 2a 20 41 53 59 4e 43 5f 43 4c  ..**.** ASYNC_CL
2af0: 4f 53 45 3a 0a 2a 2a 20 20 20 20 20 69 4f 66 66  OSE:.**     iOff
2b00: 73 65 74 20 2d 3e 20 55 6e 75 73 65 64 2e 0a 2a  set -> Unused..*
2b10: 2a 20 20 20 20 20 6e 42 79 74 65 20 20 20 2d 3e  *     nByte   ->
2b20: 20 55 6e 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 41   Unused..**.** A
2b30: 53 59 4e 43 5f 4f 50 45 4e 44 49 52 45 43 54 4f  SYNC_OPENDIRECTO
2b40: 52 59 3a 0a 2a 2a 20 20 20 20 20 69 4f 66 66 73  RY:.**     iOffs
2b50: 65 74 20 2d 3e 20 55 6e 75 73 65 64 2e 0a 2a 2a  et -> Unused..**
2b60: 20 20 20 20 20 6e 42 79 74 65 20 20 20 2d 3e 20       nByte   -> 
2b70: 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20  Number of bytes 
2b80: 6f 66 20 7a 42 75 66 20 70 6f 69 6e 74 73 20 74  of zBuf points t
2b90: 6f 20 28 64 69 72 65 63 74 6f 72 79 20 6e 61 6d  o (directory nam
2ba0: 65 29 2e 0a 2a 2a 0a 2a 2a 20 41 53 59 4e 43 5f  e)..**.** ASYNC_
2bb0: 53 45 54 46 55 4c 4c 53 59 4e 43 3a 0a 2a 2a 20  SETFULLSYNC:.** 
2bc0: 20 20 20 20 69 4f 66 66 73 65 74 20 2d 3e 20 55      iOffset -> U
2bd0: 6e 75 73 65 64 2e 0a 2a 2a 20 20 20 20 20 6e 42  nused..**     nB
2be0: 79 74 65 20 20 20 2d 3e 20 4e 65 77 20 76 61 6c  yte   -> New val
2bf0: 75 65 20 66 6f 72 20 74 68 65 20 66 75 6c 6c 2d  ue for the full-
2c00: 73 79 6e 63 20 66 6c 61 67 2e 0a 2a 2a 0a 2a 2a  sync flag..**.**
2c10: 0a 2a 2a 20 41 53 59 4e 43 5f 44 45 4c 45 54 45  .** ASYNC_DELETE
2c20: 3a 0a 2a 2a 20 20 20 20 20 69 4f 66 66 73 65 74  :.**     iOffset
2c30: 20 2d 3e 20 43 6f 6e 74 61 69 6e 73 20 74 68 65   -> Contains the
2c40: 20 22 73 79 6e 63 44 69 72 22 20 66 6c 61 67 2e   "syncDir" flag.
2c50: 0a 2a 2a 20 20 20 20 20 6e 42 79 74 65 20 20 20  .**     nByte   
2c60: 2d 3e 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74  -> Number of byt
2c70: 65 73 20 6f 66 20 7a 42 75 66 20 70 6f 69 6e 74  es of zBuf point
2c80: 73 20 74 6f 20 28 66 69 6c 65 20 6e 61 6d 65 29  s to (file name)
2c90: 2e 0a 2a 2a 0a 2a 2a 20 41 53 59 4e 43 5f 4f 50  ..**.** ASYNC_OP
2ca0: 45 4e 45 58 43 4c 55 53 49 56 45 3a 0a 2a 2a 20  ENEXCLUSIVE:.** 
2cb0: 20 20 20 20 69 4f 66 66 73 65 74 20 2d 3e 20 56      iOffset -> V
2cc0: 61 6c 75 65 20 6f 66 20 22 64 65 6c 66 6c 61 67  alue of "delflag
2cd0: 22 2e 0a 2a 2a 20 20 20 20 20 6e 42 79 74 65 20  "..**     nByte 
2ce0: 20 20 2d 3e 20 4e 75 6d 62 65 72 20 6f 66 20 62    -> Number of b
2cf0: 79 74 65 73 20 6f 66 20 7a 42 75 66 20 70 6f 69  ytes of zBuf poi
2d00: 6e 74 73 20 74 6f 20 28 66 69 6c 65 20 6e 61 6d  nts to (file nam
2d10: 65 29 2e 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 46 6f 72  e)..**.**.** For
2d20: 20 61 6e 20 41 53 59 4e 43 5f 57 52 49 54 45 20   an ASYNC_WRITE 
2d30: 6f 70 65 72 61 74 69 6f 6e 2c 20 7a 42 75 66 20  operation, zBuf 
2d40: 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 20 64 61  points to the da
2d50: 74 61 20 74 6f 20 77 72 69 74 65 20 74 6f 20 74  ta to write to t
2d60: 68 65 20 66 69 6c 65 2e 20 0a 2a 2a 20 54 68 69  he file. .** Thi
2d70: 73 20 73 70 61 63 65 20 69 73 20 73 71 6c 69 74  s space is sqlit
2d80: 65 33 5f 6d 61 6c 6c 6f 63 28 29 64 20 61 6c 6f  e3_malloc()d alo
2d90: 6e 67 20 77 69 74 68 20 74 68 65 20 41 73 79 6e  ng with the Asyn
2da0: 63 57 72 69 74 65 20 73 74 72 75 63 74 75 72 65  cWrite structure
2db0: 20 69 6e 20 61 0a 2a 2a 20 73 69 6e 67 6c 65 20   in a.** single 
2dc0: 62 6c 6f 62 2c 20 73 6f 20 69 73 20 64 65 6c 65  blob, so is dele
2dd0: 74 65 64 20 77 68 65 6e 20 73 71 6c 69 74 65 33  ted when sqlite3
2de0: 5f 66 72 65 65 28 29 20 69 73 20 63 61 6c 6c 65  _free() is calle
2df0: 64 20 6f 6e 20 74 68 65 20 70 61 72 65 6e 74 20  d on the parent 
2e00: 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 2e 0a 2a  .** structure..*
2e10: 2f 0a 73 74 72 75 63 74 20 41 73 79 6e 63 57 72  /.struct AsyncWr
2e20: 69 74 65 20 7b 0a 20 20 41 73 79 6e 63 46 69 6c  ite {.  AsyncFil
2e30: 65 44 61 74 61 20 2a 70 46 69 6c 65 44 61 74 61  eData *pFileData
2e40: 3b 20 20 20 20 2f 2a 20 46 69 6c 65 20 74 6f 20  ;    /* File to 
2e50: 77 72 69 74 65 20 64 61 74 61 20 74 6f 20 6f 72  write data to or
2e60: 20 73 79 6e 63 20 2a 2f 0a 20 20 69 6e 74 20 6f   sync */.  int o
2e70: 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  p;              
2e80: 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f          /* One o
2e90: 66 20 41 53 59 4e 43 5f 78 78 78 20 65 74 63 2e  f ASYNC_xxx etc.
2ea0: 20 2a 2f 0a 20 20 69 36 34 20 69 4f 66 66 73 65   */.  i64 iOffse
2eb0: 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 65 65  t;        /* See
2ec0: 20 61 62 6f 76 65 20 2a 2f 0a 20 20 69 6e 74 20   above */.  int 
2ed0: 6e 42 79 74 65 3b 20 20 20 20 20 20 20 20 20 20  nByte;          
2ee0: 2f 2a 20 53 65 65 20 61 62 6f 76 65 20 2a 2f 0a  /* See above */.
2ef0: 20 20 63 68 61 72 20 2a 7a 42 75 66 3b 20 20 20    char *zBuf;   
2f00: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 20 74 6f        /* Data to
2f10: 20 77 72 69 74 65 20 74 6f 20 66 69 6c 65 20 28   write to file (
2f20: 6f 72 20 4e 55 4c 4c 20 69 66 20 6f 70 21 3d 41  or NULL if op!=A
2f30: 53 59 4e 43 5f 57 52 49 54 45 29 20 2a 2f 0a 20  SYNC_WRITE) */. 
2f40: 20 41 73 79 6e 63 57 72 69 74 65 20 2a 70 4e 65   AsyncWrite *pNe
2f50: 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 77 72 69  xt;  /* Next wri
2f60: 74 65 20 6f 70 65 72 61 74 69 6f 6e 20 28 74 6f  te operation (to
2f70: 20 61 6e 79 20 66 69 6c 65 29 20 2a 2f 0a 7d 3b   any file) */.};
2f80: 0a 0a 2f 2a 20 0a 2a 2a 20 54 68 65 20 41 73 79  ../* .** The Asy
2f90: 6e 63 46 69 6c 65 20 73 74 72 75 63 74 75 72 65  ncFile structure
2fa0: 20 69 73 20 61 20 73 75 62 63 6c 61 73 73 20 6f   is a subclass o
2fb0: 66 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 75  f sqlite3_file u
2fc0: 73 65 64 20 66 6f 72 20 0a 2a 2a 20 61 73 79 6e  sed for .** asyn
2fd0: 63 68 72 6f 6e 6f 75 73 20 49 4f 2e 20 0a 2a 2a  chronous IO. .**
2fe0: 0a 2a 2a 20 41 6c 6c 20 6f 66 20 74 68 65 20 61  .** All of the a
2ff0: 63 74 75 61 6c 20 64 61 74 61 20 66 6f 72 20 74  ctual data for t
3000: 68 65 20 73 74 72 75 63 74 75 72 65 20 69 73 20  he structure is 
3010: 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 73 74  stored in the st
3020: 72 75 63 74 75 72 65 0a 2a 2a 20 70 6f 69 6e 74  ructure.** point
3030: 65 64 20 74 6f 20 62 79 20 41 73 79 6e 63 46 69  ed to by AsyncFi
3040: 6c 65 2e 70 44 61 74 61 2c 20 77 68 69 63 68 20  le.pData, which 
3050: 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 61 73 20  is allocated as 
3060: 70 61 72 74 20 6f 66 20 74 68 65 0a 2a 2a 20 73  part of the.** s
3070: 71 6c 69 74 65 33 4f 73 4f 70 65 6e 28 29 20 75  qlite3OsOpen() u
3080: 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 6d 61 6c  sing sqlite3_mal
3090: 6c 6f 63 28 29 2e 20 54 68 65 20 72 65 61 73 6f  loc(). The reaso
30a0: 6e 20 66 6f 72 20 74 68 69 73 20 69 73 20 74 68  n for this is th
30b0: 61 74 20 74 68 65 0a 2a 2a 20 6c 69 66 65 74 69  at the.** lifeti
30c0: 6d 65 20 6f 66 20 74 68 65 20 41 73 79 6e 63 46  me of the AsyncF
30d0: 69 6c 65 20 73 74 72 75 63 74 75 72 65 20 69 73  ile structure is
30e0: 20 65 6e 64 65 64 20 62 79 20 74 68 65 20 63 61   ended by the ca
30f0: 6c 6c 65 72 20 61 66 74 65 72 20 4f 73 43 6c 6f  ller after OsClo
3100: 73 65 28 29 0a 2a 2a 20 69 73 20 63 61 6c 6c 65  se().** is calle
3110: 64 2c 20 62 75 74 20 74 68 65 20 64 61 74 61 20  d, but the data 
3120: 69 6e 20 41 73 79 6e 63 46 69 6c 65 44 61 74 61  in AsyncFileData
3130: 20 6d 61 79 20 62 65 20 72 65 71 75 69 72 65 64   may be required
3140: 20 62 79 20 74 68 65 0a 2a 2a 20 77 72 69 74 65   by the.** write
3150: 72 20 74 68 72 65 61 64 20 61 66 74 65 72 20 74  r thread after t
3160: 68 61 74 20 70 6f 69 6e 74 2e 0a 2a 2f 0a 73 74  hat point..*/.st
3170: 72 75 63 74 20 41 73 79 6e 63 46 69 6c 65 20 7b  ruct AsyncFile {
3180: 0a 20 20 73 71 6c 69 74 65 33 5f 69 6f 5f 6d 65  .  sqlite3_io_me
3190: 74 68 6f 64 73 20 2a 70 4d 65 74 68 6f 64 3b 0a  thods *pMethod;.
31a0: 20 20 41 73 79 6e 63 46 69 6c 65 44 61 74 61 20    AsyncFileData 
31b0: 2a 70 44 61 74 61 3b 0a 7d 3b 0a 73 74 72 75 63  *pData;.};.struc
31c0: 74 20 41 73 79 6e 63 46 69 6c 65 44 61 74 61 20  t AsyncFileData 
31d0: 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b  {.  char *zName;
31e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
31f0: 2a 20 55 6e 64 65 72 6c 79 69 6e 67 20 4f 53 20  * Underlying OS 
3200: 66 69 6c 65 6e 61 6d 65 20 2d 20 75 73 65 64 20  filename - used 
3210: 66 6f 72 20 64 65 62 75 67 67 69 6e 67 20 2a 2f  for debugging */
3220: 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 3b 20 20 20  .  int nName;   
3230: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
3240: 20 4e 75 6d 62 65 72 20 6f 66 20 63 68 61 72 61   Number of chara
3250: 63 74 65 72 73 20 69 6e 20 7a 4e 61 6d 65 20 2a  cters in zName *
3260: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65  /.  sqlite3_file
3270: 20 2a 70 42 61 73 65 52 65 61 64 3b 20 20 20 2f   *pBaseRead;   /
3280: 2a 20 52 65 61 64 20 68 61 6e 64 6c 65 20 74 6f  * Read handle to
3290: 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20   the underlying 
32a0: 4f 73 20 66 69 6c 65 20 2a 2f 0a 20 20 73 71 6c  Os file */.  sql
32b0: 69 74 65 33 5f 66 69 6c 65 20 2a 70 42 61 73 65  ite3_file *pBase
32c0: 57 72 69 74 65 3b 20 20 2f 2a 20 57 72 69 74 65  Write;  /* Write
32d0: 20 68 61 6e 64 6c 65 20 74 6f 20 74 68 65 20 75   handle to the u
32e0: 6e 64 65 72 6c 79 69 6e 67 20 4f 73 20 66 69 6c  nderlying Os fil
32f0: 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41  e */.};../*.** A
3300: 64 64 20 61 6e 20 65 6e 74 72 79 20 74 6f 20 74  dd an entry to t
3310: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 67 6c  he end of the gl
3320: 6f 62 61 6c 20 77 72 69 74 65 2d 6f 70 20 6c 69  obal write-op li
3330: 73 74 2e 20 70 57 72 69 74 65 20 73 68 6f 75 6c  st. pWrite shoul
3340: 64 20 70 6f 69 6e 74 20 0a 2a 2a 20 74 6f 20 61  d point .** to a
3350: 6e 20 41 73 79 6e 63 57 72 69 74 65 20 73 74 72  n AsyncWrite str
3360: 75 63 74 75 72 65 20 61 6c 6c 6f 63 61 74 65 64  ucture allocated
3370: 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 6d   using sqlite3_m
3380: 61 6c 6c 6f 63 28 29 2e 20 20 54 68 65 20 77 72  alloc().  The wr
3390: 69 74 65 72 0a 2a 2a 20 74 68 72 65 61 64 20 77  iter.** thread w
33a0: 69 6c 6c 20 63 61 6c 6c 20 73 71 6c 69 74 65 33  ill call sqlite3
33b0: 5f 66 72 65 65 28 29 20 74 6f 20 66 72 65 65 20  _free() to free 
33c0: 74 68 65 20 73 74 72 75 63 74 75 72 65 20 61 66  the structure af
33d0: 74 65 72 20 74 68 65 20 73 70 65 63 69 66 69 65  ter the specifie
33e0: 64 0a 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 20 68  d.** operation h
33f0: 61 73 20 62 65 65 6e 20 63 6f 6d 70 6c 65 74 65  as been complete
3400: 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 20 61 6e  d..**.** Once an
3410: 20 41 73 79 6e 63 57 72 69 74 65 20 73 74 72 75   AsyncWrite stru
3420: 63 74 75 72 65 20 68 61 73 20 62 65 65 6e 20 61  cture has been a
3430: 64 64 65 64 20 74 6f 20 74 68 65 20 6c 69 73 74  dded to the list
3440: 2c 20 69 74 20 62 65 63 6f 6d 65 73 20 74 68 65  , it becomes the
3450: 0a 2a 2a 20 70 72 6f 70 65 72 74 79 20 6f 66 20  .** property of 
3460: 74 68 65 20 77 72 69 74 65 72 20 74 68 72 65 61  the writer threa
3470: 64 20 61 6e 64 20 6d 75 73 74 20 6e 6f 74 20 62  d and must not b
3480: 65 20 72 65 61 64 20 6f 72 20 6d 6f 64 69 66 69  e read or modifi
3490: 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 63 61 6c  ed by the.** cal
34a0: 6c 65 72 2e 20 20 0a 2a 2f 0a 73 74 61 74 69 63  ler.  .*/.static
34b0: 20 76 6f 69 64 20 61 64 64 41 73 79 6e 63 57 72   void addAsyncWr
34c0: 69 74 65 28 41 73 79 6e 63 57 72 69 74 65 20 2a  ite(AsyncWrite *
34d0: 70 57 72 69 74 65 29 7b 0a 20 20 2f 2a 20 57 65  pWrite){.  /* We
34e0: 20 6d 75 73 74 20 68 6f 6c 64 20 74 68 65 20 71   must hold the q
34f0: 75 65 75 65 20 6d 75 74 65 78 20 69 6e 20 6f 72  ueue mutex in or
3500: 64 65 72 20 74 6f 20 6d 6f 64 69 66 79 20 74 68  der to modify th
3510: 65 20 71 75 65 75 65 20 70 6f 69 6e 74 65 72 73  e queue pointers
3520: 20 2a 2f 0a 20 20 70 74 68 72 65 61 64 5f 6d 75   */.  pthread_mu
3530: 74 65 78 5f 6c 6f 63 6b 28 26 61 73 79 6e 63 2e  tex_lock(&async.
3540: 71 75 65 75 65 4d 75 74 65 78 29 3b 0a 0a 20 20  queueMutex);..  
3550: 2f 2a 20 41 64 64 20 74 68 65 20 72 65 63 6f 72  /* Add the recor
3560: 64 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 20  d to the end of 
3570: 74 68 65 20 77 72 69 74 65 2d 6f 70 20 71 75 65  the write-op que
3580: 75 65 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  ue */.  assert( 
3590: 21 70 57 72 69 74 65 2d 3e 70 4e 65 78 74 20 29  !pWrite->pNext )
35a0: 3b 0a 20 20 69 66 28 20 61 73 79 6e 63 2e 70 51  ;.  if( async.pQ
35b0: 75 65 75 65 4c 61 73 74 20 29 7b 0a 20 20 20 20  ueueLast ){.    
35c0: 61 73 73 65 72 74 28 20 61 73 79 6e 63 2e 70 51  assert( async.pQ
35d0: 75 65 75 65 46 69 72 73 74 20 29 3b 0a 20 20 20  ueueFirst );.   
35e0: 20 61 73 79 6e 63 2e 70 51 75 65 75 65 4c 61 73   async.pQueueLas
35f0: 74 2d 3e 70 4e 65 78 74 20 3d 20 70 57 72 69 74  t->pNext = pWrit
3600: 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  e;.  }else{.    
3610: 61 73 79 6e 63 2e 70 51 75 65 75 65 46 69 72 73  async.pQueueFirs
3620: 74 20 3d 20 70 57 72 69 74 65 3b 0a 20 20 7d 0a  t = pWrite;.  }.
3630: 20 20 61 73 79 6e 63 2e 70 51 75 65 75 65 4c 61    async.pQueueLa
3640: 73 74 20 3d 20 70 57 72 69 74 65 3b 0a 20 20 41  st = pWrite;.  A
3650: 53 59 4e 43 5f 54 52 41 43 45 28 28 22 50 55 53  SYNC_TRACE(("PUS
3660: 48 20 25 70 20 28 25 73 20 25 73 20 25 64 29 5c  H %p (%s %s %d)\
3670: 6e 22 2c 20 70 57 72 69 74 65 2c 20 61 7a 4f 70  n", pWrite, azOp
3680: 63 6f 64 65 4e 61 6d 65 5b 70 57 72 69 74 65 2d  codeName[pWrite-
3690: 3e 6f 70 5d 2c 0a 20 20 20 20 20 20 20 20 20 70  >op],.         p
36a0: 57 72 69 74 65 2d 3e 70 46 69 6c 65 44 61 74 61  Write->pFileData
36b0: 20 3f 20 70 57 72 69 74 65 2d 3e 70 46 69 6c 65   ? pWrite->pFile
36c0: 44 61 74 61 2d 3e 7a 4e 61 6d 65 20 3a 20 22 2d  Data->zName : "-
36d0: 22 2c 20 70 57 72 69 74 65 2d 3e 69 4f 66 66 73  ", pWrite->iOffs
36e0: 65 74 29 29 3b 0a 0a 20 20 69 66 28 20 70 57 72  et));..  if( pWr
36f0: 69 74 65 2d 3e 6f 70 3d 3d 41 53 59 4e 43 5f 43  ite->op==ASYNC_C
3700: 4c 4f 53 45 20 29 7b 0a 20 20 20 20 61 73 79 6e  LOSE ){.    asyn
3710: 63 2e 6e 46 69 6c 65 2d 2d 3b 0a 20 20 20 20 69  c.nFile--;.    i
3720: 66 28 20 61 73 79 6e 63 2e 6e 46 69 6c 65 3d 3d  f( async.nFile==
3730: 30 20 29 7b 0a 20 20 20 20 20 20 61 73 79 6e 63  0 ){.      async
3740: 2e 69 6f 45 72 72 6f 72 20 3d 20 53 51 4c 49 54  .ioError = SQLIT
3750: 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  E_OK;.    }.  }.
3760: 0a 20 20 2f 2a 20 44 72 6f 70 20 74 68 65 20 71  .  /* Drop the q
3770: 75 65 75 65 20 6d 75 74 65 78 20 2a 2f 0a 20 20  ueue mutex */.  
3780: 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e  pthread_mutex_un
3790: 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 71 75 65 75  lock(&async.queu
37a0: 65 4d 75 74 65 78 29 3b 0a 0a 20 20 2f 2a 20 54  eMutex);..  /* T
37b0: 68 65 20 77 72 69 74 65 72 20 74 68 72 65 61 64  he writer thread
37c0: 20 6d 69 67 68 74 20 68 61 76 65 20 62 65 65 6e   might have been
37d0: 20 69 64 6c 65 20 62 65 63 61 75 73 65 20 74 68   idle because th
37e0: 65 72 65 20 77 61 73 20 6e 6f 74 68 69 6e 67 0a  ere was nothing.
37f0: 20 20 2a 2a 20 6f 6e 20 74 68 65 20 77 72 69 74    ** on the writ
3800: 65 2d 6f 70 20 71 75 65 75 65 20 66 6f 72 20 69  e-op queue for i
3810: 74 20 74 6f 20 64 6f 2e 20 20 53 6f 20 77 61 6b  t to do.  So wak
3820: 65 20 69 74 20 75 70 2e 20 2a 2f 0a 20 20 70 74  e it up. */.  pt
3830: 68 72 65 61 64 5f 63 6f 6e 64 5f 73 69 67 6e 61  hread_cond_signa
3840: 6c 28 26 61 73 79 6e 63 2e 71 75 65 75 65 53 69  l(&async.queueSi
3850: 67 6e 61 6c 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  gnal);.}../*.** 
3860: 49 6e 63 72 65 6d 65 6e 74 20 61 73 79 6e 63 2e  Increment async.
3870: 6e 46 69 6c 65 20 69 6e 20 61 20 74 68 72 65 61  nFile in a threa
3880: 64 2d 73 61 66 65 20 6d 61 6e 6e 65 72 2e 0a 2a  d-safe manner..*
3890: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 69 6e  /.static void in
38a0: 63 72 4f 70 65 6e 46 69 6c 65 43 6f 75 6e 74 28  crOpenFileCount(
38b0: 29 7b 0a 20 20 2f 2a 20 57 65 20 6d 75 73 74 20  ){.  /* We must 
38c0: 68 6f 6c 64 20 74 68 65 20 71 75 65 75 65 20 6d  hold the queue m
38d0: 75 74 65 78 20 69 6e 20 6f 72 64 65 72 20 74 6f  utex in order to
38e0: 20 6d 6f 64 69 66 79 20 61 73 79 6e 63 2e 6e 46   modify async.nF
38f0: 69 6c 65 20 2a 2f 0a 20 20 70 74 68 72 65 61 64  ile */.  pthread
3900: 5f 6d 75 74 65 78 5f 6c 6f 63 6b 28 26 61 73 79  _mutex_lock(&asy
3910: 6e 63 2e 71 75 65 75 65 4d 75 74 65 78 29 3b 0a  nc.queueMutex);.
3920: 20 20 69 66 28 20 61 73 79 6e 63 2e 6e 46 69 6c    if( async.nFil
3930: 65 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 79 6e  e==0 ){.    asyn
3940: 63 2e 69 6f 45 72 72 6f 72 20 3d 20 53 51 4c 49  c.ioError = SQLI
3950: 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 61 73 79  TE_OK;.  }.  asy
3960: 6e 63 2e 6e 46 69 6c 65 2b 2b 3b 0a 20 20 70 74  nc.nFile++;.  pt
3970: 68 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f  hread_mutex_unlo
3980: 63 6b 28 26 61 73 79 6e 63 2e 71 75 65 75 65 4d  ck(&async.queueM
3990: 75 74 65 78 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  utex);.}../*.** 
39a0: 54 68 69 73 20 69 73 20 61 20 75 74 69 6c 69 74  This is a utilit
39b0: 79 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 61 6c  y function to al
39c0: 6c 6f 63 61 74 65 20 61 6e 64 20 70 6f 70 75 6c  locate and popul
39d0: 61 74 65 20 61 20 6e 65 77 20 41 73 79 6e 63 57  ate a new AsyncW
39e0: 72 69 74 65 0a 2a 2a 20 73 74 72 75 63 74 75 72  rite.** structur
39f0: 65 20 61 6e 64 20 69 6e 73 65 72 74 20 69 74 20  e and insert it 
3a00: 28 76 69 61 20 61 64 64 41 73 79 6e 63 57 72 69  (via addAsyncWri
3a10: 74 65 28 29 20 29 20 69 6e 74 6f 20 74 68 65 20  te() ) into the 
3a20: 67 6c 6f 62 61 6c 20 6c 69 73 74 2e 0a 2a 2f 0a  global list..*/.
3a30: 73 74 61 74 69 63 20 69 6e 74 20 61 64 64 4e 65  static int addNe
3a40: 77 41 73 79 6e 63 57 72 69 74 65 28 0a 20 20 41  wAsyncWrite(.  A
3a50: 73 79 6e 63 46 69 6c 65 44 61 74 61 20 2a 70 46  syncFileData *pF
3a60: 69 6c 65 44 61 74 61 2c 20 0a 20 20 69 6e 74 20  ileData, .  int 
3a70: 6f 70 2c 20 0a 20 20 69 36 34 20 69 4f 66 66 73  op, .  i64 iOffs
3a80: 65 74 2c 20 0a 20 20 69 6e 74 20 6e 42 79 74 65  et, .  int nByte
3a90: 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  ,.  const char *
3aa0: 7a 42 79 74 65 0a 29 7b 0a 20 20 41 73 79 6e 63  zByte.){.  Async
3ab0: 57 72 69 74 65 20 2a 70 3b 0a 20 20 69 66 28 20  Write *p;.  if( 
3ac0: 6f 70 21 3d 41 53 59 4e 43 5f 43 4c 4f 53 45 20  op!=ASYNC_CLOSE 
3ad0: 26 26 20 61 73 79 6e 63 2e 69 6f 45 72 72 6f 72  && async.ioError
3ae0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 61   ){.    return a
3af0: 73 79 6e 63 2e 69 6f 45 72 72 6f 72 3b 0a 20 20  sync.ioError;.  
3b00: 7d 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 5f  }.  p = sqlite3_
3b10: 6d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 41 73  malloc(sizeof(As
3b20: 79 6e 63 57 72 69 74 65 29 20 2b 20 28 7a 42 79  yncWrite) + (zBy
3b30: 74 65 3f 6e 42 79 74 65 3a 30 29 29 3b 0a 20 20  te?nByte:0));.  
3b40: 69 66 28 20 21 70 20 29 7b 0a 20 20 20 20 72 65  if( !p ){.    re
3b50: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  turn SQLITE_NOME
3b60: 4d 3b 0a 20 20 7d 0a 20 20 70 2d 3e 6f 70 20 3d  M;.  }.  p->op =
3b70: 20 6f 70 3b 0a 20 20 70 2d 3e 69 4f 66 66 73 65   op;.  p->iOffse
3b80: 74 20 3d 20 69 4f 66 66 73 65 74 3b 0a 20 20 70  t = iOffset;.  p
3b90: 2d 3e 6e 42 79 74 65 20 3d 20 6e 42 79 74 65 3b  ->nByte = nByte;
3ba0: 0a 20 20 70 2d 3e 70 46 69 6c 65 44 61 74 61 20  .  p->pFileData 
3bb0: 3d 20 70 46 69 6c 65 44 61 74 61 3b 0a 20 20 70  = pFileData;.  p
3bc0: 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 69  ->pNext = 0;.  i
3bd0: 66 28 20 7a 42 79 74 65 20 29 7b 0a 20 20 20 20  f( zByte ){.    
3be0: 70 2d 3e 7a 42 75 66 20 3d 20 28 63 68 61 72 20  p->zBuf = (char 
3bf0: 2a 29 26 70 5b 31 5d 3b 0a 20 20 20 20 6d 65 6d  *)&p[1];.    mem
3c00: 63 70 79 28 70 2d 3e 7a 42 75 66 2c 20 7a 42 79  cpy(p->zBuf, zBy
3c10: 74 65 2c 20 6e 42 79 74 65 29 3b 0a 20 20 7d 65  te, nByte);.  }e
3c20: 6c 73 65 7b 0a 20 20 20 20 70 2d 3e 7a 42 75 66  lse{.    p->zBuf
3c30: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 61 64 64 41   = 0;.  }.  addA
3c40: 73 79 6e 63 57 72 69 74 65 28 70 29 3b 0a 20 20  syncWrite(p);.  
3c50: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
3c60: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65  ;.}../*.** Close
3c70: 20 74 68 65 20 66 69 6c 65 2e 20 54 68 69 73 20   the file. This 
3c80: 6a 75 73 74 20 61 64 64 73 20 61 6e 20 65 6e 74  just adds an ent
3c90: 72 79 20 74 6f 20 74 68 65 20 77 72 69 74 65 2d  ry to the write-
3ca0: 6f 70 20 6c 69 73 74 2c 20 74 68 65 20 66 69 6c  op list, the fil
3cb0: 65 20 69 73 0a 2a 2a 20 6e 6f 74 20 61 63 74 75  e is.** not actu
3cc0: 61 6c 6c 79 20 63 6c 6f 73 65 64 2e 0a 2a 2f 0a  ally closed..*/.
3cd0: 73 74 61 74 69 63 20 69 6e 74 20 61 73 79 6e 63  static int async
3ce0: 43 6c 6f 73 65 28 73 71 6c 69 74 65 33 5f 66 69  Close(sqlite3_fi
3cf0: 6c 65 20 2a 70 46 69 6c 65 29 7b 0a 20 20 41 73  le *pFile){.  As
3d00: 79 6e 63 46 69 6c 65 44 61 74 61 20 2a 70 20 3d  yncFileData *p =
3d10: 20 28 28 41 73 79 6e 63 46 69 6c 65 20 2a 29 70   ((AsyncFile *)p
3d20: 46 69 6c 65 29 2d 3e 70 44 61 74 61 3b 0a 20 20  File)->pData;.  
3d30: 72 65 74 75 72 6e 20 61 64 64 4e 65 77 41 73 79  return addNewAsy
3d40: 6e 63 57 72 69 74 65 28 70 2c 20 41 53 59 4e 43  ncWrite(p, ASYNC
3d50: 5f 43 4c 4f 53 45 2c 20 30 2c 20 30 2c 20 30 29  _CLOSE, 0, 0, 0)
3d60: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65  ;.}../*.** Imple
3d70: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 73 71 6c  mentation of sql
3d80: 69 74 65 33 4f 73 57 72 69 74 65 28 29 20 66 6f  ite3OsWrite() fo
3d90: 72 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 66  r asynchronous f
3da0: 69 6c 65 73 2e 20 49 6e 73 74 65 61 64 20 6f 66  iles. Instead of
3db0: 20 0a 2a 2a 20 77 72 69 74 69 6e 67 20 74 6f 20   .** writing to 
3dc0: 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 66  the underlying f
3dd0: 69 6c 65 2c 20 74 68 69 73 20 66 75 6e 63 74 69  ile, this functi
3de0: 6f 6e 20 61 64 64 73 20 61 6e 20 65 6e 74 72 79  on adds an entry
3df0: 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 0a 2a   to the end of.*
3e00: 2a 20 74 68 65 20 67 6c 6f 62 61 6c 20 41 73 79  * the global Asy
3e10: 6e 63 57 72 69 74 65 20 6c 69 73 74 2e 20 45 69  ncWrite list. Ei
3e20: 74 68 65 72 20 53 51 4c 49 54 45 5f 4f 4b 20 6f  ther SQLITE_OK o
3e30: 72 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 6d  r SQLITE_NOMEM m
3e40: 61 79 20 62 65 0a 2a 2a 20 72 65 74 75 72 6e 65  ay be.** returne
3e50: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  d..*/.static int
3e60: 20 61 73 79 6e 63 57 72 69 74 65 28 73 71 6c 69   asyncWrite(sqli
3e70: 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c  te3_file *pFile,
3e80: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 42 75   const void *pBu
3e90: 66 2c 20 69 6e 74 20 61 6d 74 2c 20 69 36 34 20  f, int amt, i64 
3ea0: 69 4f 66 66 29 7b 0a 20 20 41 73 79 6e 63 46 69  iOff){.  AsyncFi
3eb0: 6c 65 44 61 74 61 20 2a 70 20 3d 20 28 28 41 73  leData *p = ((As
3ec0: 79 6e 63 46 69 6c 65 20 2a 29 70 46 69 6c 65 29  yncFile *)pFile)
3ed0: 2d 3e 70 44 61 74 61 3b 0a 20 20 72 65 74 75 72  ->pData;.  retur
3ee0: 6e 20 61 64 64 4e 65 77 41 73 79 6e 63 57 72 69  n addNewAsyncWri
3ef0: 74 65 28 70 2c 20 41 53 59 4e 43 5f 57 52 49 54  te(p, ASYNC_WRIT
3f00: 45 2c 20 69 4f 66 66 2c 20 61 6d 74 2c 20 70 42  E, iOff, amt, pB
3f10: 75 66 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  uf);.}../*.** Re
3f20: 61 64 20 64 61 74 61 20 66 72 6f 6d 20 74 68 65  ad data from the
3f30: 20 66 69 6c 65 2e 20 46 69 72 73 74 20 77 65 20   file. First we 
3f40: 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 66 69  read from the fi
3f50: 6c 65 73 79 73 74 65 6d 2c 20 74 68 65 6e 20 61  lesystem, then a
3f60: 64 6a 75 73 74 20 0a 2a 2a 20 74 68 65 20 63 6f  djust .** the co
3f70: 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 62 75  ntents of the bu
3f80: 66 66 65 72 20 62 61 73 65 64 20 6f 6e 20 41 53  ffer based on AS
3f90: 59 4e 43 5f 57 52 49 54 45 20 6f 70 65 72 61 74  YNC_WRITE operat
3fa0: 69 6f 6e 73 20 69 6e 20 74 68 65 20 0a 2a 2a 20  ions in the .** 
3fb0: 77 72 69 74 65 2d 6f 70 20 71 75 65 75 65 2e 0a  write-op queue..
3fc0: 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d 65 74 68 6f  **.** This metho
3fd0: 64 20 68 6f 6c 64 73 20 74 68 65 20 6d 75 74 65  d holds the mute
3fe0: 78 20 66 72 6f 6d 20 73 74 61 72 74 20 74 6f 20  x from start to 
3ff0: 66 69 6e 69 73 68 2e 0a 2a 2f 0a 73 74 61 74 69  finish..*/.stati
4000: 63 20 69 6e 74 20 61 73 79 6e 63 52 65 61 64 28  c int asyncRead(
4010: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46  sqlite3_file *pF
4020: 69 6c 65 2c 20 76 6f 69 64 20 2a 7a 4f 75 74 2c  ile, void *zOut,
4030: 20 69 6e 74 20 69 41 6d 74 2c 20 69 36 34 20 69   int iAmt, i64 i
4040: 4f 66 66 73 65 74 29 7b 0a 20 20 41 73 79 6e 63  Offset){.  Async
4050: 46 69 6c 65 44 61 74 61 20 2a 70 20 3d 20 28 28  FileData *p = ((
4060: 41 73 79 6e 63 46 69 6c 65 20 2a 29 70 46 69 6c  AsyncFile *)pFil
4070: 65 29 2d 3e 70 44 61 74 61 3b 0a 20 20 69 6e 74  e)->pData;.  int
4080: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
4090: 0a 20 20 69 36 34 20 66 69 6c 65 73 69 7a 65 3b  .  i64 filesize;
40a0: 0a 20 20 69 6e 74 20 6e 52 65 61 64 3b 0a 20 20  .  int nRead;.  
40b0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 42  sqlite3_file *pB
40c0: 61 73 65 20 3d 20 70 2d 3e 70 42 61 73 65 52 65  ase = p->pBaseRe
40d0: 61 64 3b 0a 0a 20 20 2f 2a 20 49 66 20 61 6e 20  ad;..  /* If an 
40e0: 49 2f 4f 20 65 72 72 6f 72 20 68 61 73 20 70 72  I/O error has pr
40f0: 65 76 69 6f 75 73 6c 79 20 6f 63 63 75 72 72 65  eviously occurre
4100: 64 20 69 6e 20 74 68 69 73 20 76 69 72 74 75 61  d in this virtua
4110: 6c 20 66 69 6c 65 20 0a 20 20 2a 2a 20 73 79 73  l file .  ** sys
4120: 74 65 6d 2c 20 74 68 65 6e 20 61 6c 6c 20 73 75  tem, then all su
4130: 62 73 65 71 75 65 6e 74 20 6f 70 65 72 61 74 69  bsequent operati
4140: 6f 6e 73 20 66 61 69 6c 2e 0a 20 20 2a 2f 0a 20  ons fail..  */. 
4150: 20 69 66 28 20 61 73 79 6e 63 2e 69 6f 45 72 72   if( async.ioErr
4160: 6f 72 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  or!=SQLITE_OK ){
4170: 0a 20 20 20 20 72 65 74 75 72 6e 20 61 73 79 6e  .    return asyn
4180: 63 2e 69 6f 45 72 72 6f 72 3b 0a 20 20 7d 0a 0a  c.ioError;.  }..
4190: 20 20 2f 2a 20 47 72 61 62 20 74 68 65 20 77 72    /* Grab the wr
41a0: 69 74 65 20 71 75 65 75 65 20 6d 75 74 65 78 20  ite queue mutex 
41b0: 66 6f 72 20 74 68 65 20 64 75 72 61 74 69 6f 6e  for the duration
41c0: 20 6f 66 20 74 68 65 20 63 61 6c 6c 20 2a 2f 0a   of the call */.
41d0: 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f    pthread_mutex_
41e0: 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 71 75 65 75  lock(&async.queu
41f0: 65 4d 75 74 65 78 29 3b 0a 0a 20 20 69 66 28 20  eMutex);..  if( 
4200: 70 42 61 73 65 2d 3e 70 4d 65 74 68 6f 64 73 20  pBase->pMethods 
4210: 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  ){.    rc = sqli
4220: 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 28 70 42  te3OsFileSize(pB
4230: 61 73 65 2c 20 26 66 69 6c 65 73 69 7a 65 29 3b  ase, &filesize);
4240: 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c  .    if( rc!=SQL
4250: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
4260: 67 6f 74 6f 20 61 73 79 6e 63 72 65 61 64 5f 6f  goto asyncread_o
4270: 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6e 52  ut;.    }.    nR
4280: 65 61 64 20 3d 20 4d 49 4e 28 66 69 6c 65 73 69  ead = MIN(filesi
4290: 7a 65 20 2d 20 69 4f 66 66 73 65 74 2c 20 69 41  ze - iOffset, iA
42a0: 6d 74 29 3b 0a 20 20 20 20 69 66 28 20 6e 52 65  mt);.    if( nRe
42b0: 61 64 3e 30 20 29 7b 0a 20 20 20 20 20 20 72 63  ad>0 ){.      rc
42c0: 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64   = sqlite3OsRead
42d0: 28 70 42 61 73 65 2c 20 7a 4f 75 74 2c 20 6e 52  (pBase, zOut, nR
42e0: 65 61 64 2c 20 69 4f 66 66 73 65 74 29 3b 0a 20  ead, iOffset);. 
42f0: 20 20 20 20 20 41 53 59 4e 43 5f 54 52 41 43 45       ASYNC_TRACE
4300: 28 28 22 52 45 41 44 20 25 73 20 25 64 20 62 79  (("READ %s %d by
4310: 74 65 73 20 61 74 20 25 64 5c 6e 22 2c 20 70 2d  tes at %d\n", p-
4320: 3e 7a 4e 61 6d 65 2c 20 6e 52 65 61 64 2c 20 69  >zName, nRead, i
4330: 4f 66 66 73 65 74 29 29 3b 0a 20 20 20 20 7d 0a  Offset));.    }.
4340: 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53    }..  if( rc==S
4350: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
4360: 41 73 79 6e 63 57 72 69 74 65 20 2a 70 57 72 69  AsyncWrite *pWri
4370: 74 65 3b 0a 0a 20 20 20 20 66 6f 72 28 70 57 72  te;..    for(pWr
4380: 69 74 65 3d 61 73 79 6e 63 2e 70 51 75 65 75 65  ite=async.pQueue
4390: 46 69 72 73 74 3b 20 70 57 72 69 74 65 3b 20 70  First; pWrite; p
43a0: 57 72 69 74 65 20 3d 20 70 57 72 69 74 65 2d 3e  Write = pWrite->
43b0: 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 69 66  pNext){.      if
43c0: 28 20 70 57 72 69 74 65 2d 3e 70 46 69 6c 65 44  ( pWrite->pFileD
43d0: 61 74 61 3d 3d 70 20 26 26 20 70 57 72 69 74 65  ata==p && pWrite
43e0: 2d 3e 6f 70 3d 3d 41 53 59 4e 43 5f 57 52 49 54  ->op==ASYNC_WRIT
43f0: 45 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74  E ){.        int
4400: 20 69 42 65 67 69 6e 4f 75 74 20 3d 20 28 70 57   iBeginOut = (pW
4410: 72 69 74 65 2d 3e 69 4f 66 66 73 65 74 2d 69 4f  rite->iOffset-iO
4420: 66 66 73 65 74 29 3b 0a 20 20 20 20 20 20 20 20  ffset);.        
4430: 69 6e 74 20 69 42 65 67 69 6e 49 6e 20 3d 20 2d  int iBeginIn = -
4440: 69 42 65 67 69 6e 4f 75 74 3b 0a 20 20 20 20 20  iBeginOut;.     
4450: 20 20 20 69 6e 74 20 6e 43 6f 70 79 3b 0a 0a 20     int nCopy;.. 
4460: 20 20 20 20 20 20 20 69 66 28 20 69 42 65 67 69         if( iBegi
4470: 6e 49 6e 3c 30 20 29 20 69 42 65 67 69 6e 49 6e  nIn<0 ) iBeginIn
4480: 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 69 66   = 0;.        if
4490: 28 20 69 42 65 67 69 6e 4f 75 74 3c 30 20 29 20  ( iBeginOut<0 ) 
44a0: 69 42 65 67 69 6e 4f 75 74 20 3d 20 30 3b 0a 20  iBeginOut = 0;. 
44b0: 20 20 20 20 20 20 20 6e 43 6f 70 79 20 3d 20 4d         nCopy = M
44c0: 49 4e 28 70 57 72 69 74 65 2d 3e 6e 42 79 74 65  IN(pWrite->nByte
44d0: 2d 69 42 65 67 69 6e 49 6e 2c 20 69 41 6d 74 2d  -iBeginIn, iAmt-
44e0: 69 42 65 67 69 6e 4f 75 74 29 3b 0a 0a 20 20 20  iBeginOut);..   
44f0: 20 20 20 20 20 69 66 28 20 6e 43 6f 70 79 3e 30       if( nCopy>0
4500: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6d 65   ){.          me
4510: 6d 63 70 79 28 26 28 28 63 68 61 72 20 2a 29 7a  mcpy(&((char *)z
4520: 4f 75 74 29 5b 69 42 65 67 69 6e 4f 75 74 5d 2c  Out)[iBeginOut],
4530: 20 26 70 57 72 69 74 65 2d 3e 7a 42 75 66 5b 69   &pWrite->zBuf[i
4540: 42 65 67 69 6e 49 6e 5d 2c 20 6e 43 6f 70 79 29  BeginIn], nCopy)
4550: 3b 0a 20 20 20 20 20 20 20 20 20 20 41 53 59 4e  ;.          ASYN
4560: 43 5f 54 52 41 43 45 28 28 22 4f 56 45 52 52 45  C_TRACE(("OVERRE
4570: 41 44 20 25 64 20 62 79 74 65 73 20 61 74 20 25  AD %d bytes at %
4580: 64 5c 6e 22 2c 20 6e 43 6f 70 79 2c 20 69 42 65  d\n", nCopy, iBe
4590: 67 69 6e 4f 75 74 2b 69 4f 66 66 73 65 74 29 29  ginOut+iOffset))
45a0: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
45b0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 61    }.    }.  }..a
45c0: 73 79 6e 63 72 65 61 64 5f 6f 75 74 3a 0a 20 20  syncread_out:.  
45d0: 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e  pthread_mutex_un
45e0: 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 71 75 65 75  lock(&async.queu
45f0: 65 4d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72  eMutex);.  retur
4600: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  n rc;.}../*.** T
4610: 72 75 6e 63 61 74 65 20 74 68 65 20 66 69 6c 65  runcate the file
4620: 20 74 6f 20 6e 42 79 74 65 20 62 79 74 65 73 20   to nByte bytes 
4630: 69 6e 20 6c 65 6e 67 74 68 2e 20 54 68 69 73 20  in length. This 
4640: 6a 75 73 74 20 61 64 64 73 20 61 6e 20 65 6e 74  just adds an ent
4650: 72 79 20 74 6f 20 0a 2a 2a 20 74 68 65 20 77 72  ry to .** the wr
4660: 69 74 65 2d 6f 70 20 6c 69 73 74 2c 20 6e 6f 20  ite-op list, no 
4670: 49 4f 20 61 63 74 75 61 6c 6c 79 20 74 61 6b 65  IO actually take
4680: 73 20 70 6c 61 63 65 2e 0a 2a 2f 0a 73 74 61 74  s place..*/.stat
4690: 69 63 20 69 6e 74 20 61 73 79 6e 63 54 72 75 6e  ic int asyncTrun
46a0: 63 61 74 65 28 73 71 6c 69 74 65 33 5f 66 69 6c  cate(sqlite3_fil
46b0: 65 20 2a 70 46 69 6c 65 2c 20 69 36 34 20 6e 42  e *pFile, i64 nB
46c0: 79 74 65 29 7b 0a 20 20 41 73 79 6e 63 46 69 6c  yte){.  AsyncFil
46d0: 65 44 61 74 61 20 2a 70 20 3d 20 28 28 41 73 79  eData *p = ((Asy
46e0: 6e 63 46 69 6c 65 20 2a 29 70 46 69 6c 65 29 2d  ncFile *)pFile)-
46f0: 3e 70 44 61 74 61 3b 0a 20 20 72 65 74 75 72 6e  >pData;.  return
4700: 20 61 64 64 4e 65 77 41 73 79 6e 63 57 72 69 74   addNewAsyncWrit
4710: 65 28 70 2c 20 41 53 59 4e 43 5f 54 52 55 4e 43  e(p, ASYNC_TRUNC
4720: 41 54 45 2c 20 6e 42 79 74 65 2c 20 30 2c 20 30  ATE, nByte, 0, 0
4730: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 79 6e 63  );.}../*.** Sync
4740: 20 74 68 65 20 66 69 6c 65 2e 20 54 68 69 73 20   the file. This 
4750: 6a 75 73 74 20 61 64 64 73 20 61 6e 20 65 6e 74  just adds an ent
4760: 72 79 20 74 6f 20 74 68 65 20 77 72 69 74 65 2d  ry to the write-
4770: 6f 70 20 6c 69 73 74 2c 20 74 68 65 20 0a 2a 2a  op list, the .**
4780: 20 73 79 6e 63 28 29 20 69 73 20 64 6f 6e 65 20   sync() is done 
4790: 6c 61 74 65 72 20 62 79 20 73 71 6c 69 74 65 33  later by sqlite3
47a0: 5f 61 73 79 6e 63 5f 66 6c 75 73 68 28 29 2e 0a  _async_flush()..
47b0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 73  */.static int as
47c0: 79 6e 63 53 79 6e 63 28 73 71 6c 69 74 65 33 5f  yncSync(sqlite3_
47d0: 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 69 6e 74  file *pFile, int
47e0: 20 66 6c 61 67 73 29 7b 0a 20 20 41 73 79 6e 63   flags){.  Async
47f0: 46 69 6c 65 44 61 74 61 20 2a 70 20 3d 20 28 28  FileData *p = ((
4800: 41 73 79 6e 63 46 69 6c 65 20 2a 29 70 46 69 6c  AsyncFile *)pFil
4810: 65 29 2d 3e 70 44 61 74 61 3b 0a 20 20 72 65 74  e)->pData;.  ret
4820: 75 72 6e 20 61 64 64 4e 65 77 41 73 79 6e 63 57  urn addNewAsyncW
4830: 72 69 74 65 28 70 2c 20 41 53 59 4e 43 5f 53 59  rite(p, ASYNC_SY
4840: 4e 43 2c 20 30 2c 20 66 6c 61 67 73 2c 20 30 29  NC, 0, flags, 0)
4850: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20  ;.}../*.** Read 
4860: 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20  the size of the 
4870: 66 69 6c 65 2e 20 46 69 72 73 74 20 77 65 20 72  file. First we r
4880: 65 61 64 20 74 68 65 20 73 69 7a 65 20 6f 66 20  ead the size of 
4890: 74 68 65 20 66 69 6c 65 20 73 79 73 74 65 6d 20  the file system 
48a0: 0a 2a 2a 20 65 6e 74 72 79 2c 20 74 68 65 6e 20  .** entry, then 
48b0: 61 64 6a 75 73 74 20 66 6f 72 20 61 6e 79 20 41  adjust for any A
48c0: 53 59 4e 43 5f 57 52 49 54 45 20 6f 72 20 41 53  SYNC_WRITE or AS
48d0: 59 4e 43 5f 54 52 55 4e 43 41 54 45 20 6f 70 65  YNC_TRUNCATE ope
48e0: 72 61 74 69 6f 6e 73 20 0a 2a 2a 20 63 75 72 72  rations .** curr
48f0: 65 6e 74 6c 79 20 69 6e 20 74 68 65 20 77 72 69  ently in the wri
4900: 74 65 2d 6f 70 20 6c 69 73 74 2e 20 0a 2a 2a 0a  te-op list. .**.
4910: 2a 2a 20 54 68 69 73 20 6d 65 74 68 6f 64 20 68  ** This method h
4920: 6f 6c 64 73 20 74 68 65 20 6d 75 74 65 78 20 66  olds the mutex f
4930: 72 6f 6d 20 73 74 61 72 74 20 74 6f 20 66 69 6e  rom start to fin
4940: 69 73 68 2e 0a 2a 2f 0a 69 6e 74 20 61 73 79 6e  ish..*/.int asyn
4950: 63 46 69 6c 65 53 69 7a 65 28 73 71 6c 69 74 65  cFileSize(sqlite
4960: 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 69  3_file *pFile, i
4970: 36 34 20 2a 70 69 53 69 7a 65 29 7b 0a 20 20 41  64 *piSize){.  A
4980: 73 79 6e 63 46 69 6c 65 44 61 74 61 20 2a 70 20  syncFileData *p 
4990: 3d 20 28 28 41 73 79 6e 63 46 69 6c 65 20 2a 29  = ((AsyncFile *)
49a0: 70 46 69 6c 65 29 2d 3e 70 44 61 74 61 3b 0a 20  pFile)->pData;. 
49b0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45   int rc = SQLITE
49c0: 5f 4f 4b 3b 0a 20 20 69 36 34 20 73 20 3d 20 30  _OK;.  i64 s = 0
49d0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65  ;.  sqlite3_file
49e0: 20 2a 70 42 61 73 65 3b 0a 0a 20 20 70 74 68 72   *pBase;..  pthr
49f0: 65 61 64 5f 6d 75 74 65 78 5f 6c 6f 63 6b 28 26  ead_mutex_lock(&
4a00: 61 73 79 6e 63 2e 71 75 65 75 65 4d 75 74 65 78  async.queueMutex
4a10: 29 3b 0a 0a 20 20 2f 2a 20 52 65 61 64 20 74 68  );..  /* Read th
4a20: 65 20 66 69 6c 65 73 79 73 74 65 6d 20 73 69 7a  e filesystem siz
4a30: 65 20 66 72 6f 6d 20 74 68 65 20 62 61 73 65 20  e from the base 
4a40: 66 69 6c 65 2e 20 49 66 20 70 42 61 73 65 52 65  file. If pBaseRe
4a50: 61 64 20 69 73 20 4e 55 4c 4c 2c 20 74 68 69 73  ad is NULL, this
4a60: 0a 20 20 2a 2a 20 6d 65 61 6e 73 20 74 68 65 20  .  ** means the 
4a70: 66 69 6c 65 20 68 61 73 6e 27 74 20 62 65 65 6e  file hasn't been
4a80: 20 6f 70 65 6e 65 64 20 79 65 74 2e 20 49 6e 20   opened yet. In 
4a90: 74 68 69 73 20 63 61 73 65 20 61 6c 6c 20 72 65  this case all re
4aa0: 6c 65 76 61 6e 74 20 64 61 74 61 20 0a 20 20 2a  levant data .  *
4ab0: 2a 20 6d 75 73 74 20 62 65 20 69 6e 20 74 68 65  * must be in the
4ac0: 20 77 72 69 74 65 2d 6f 70 20 71 75 65 75 65 20   write-op queue 
4ad0: 61 6e 79 77 61 79 2c 20 73 6f 20 77 65 20 63 61  anyway, so we ca
4ae0: 6e 20 6f 6d 69 74 20 72 65 61 64 69 6e 67 20 66  n omit reading f
4af0: 72 6f 6d 20 74 68 65 0a 20 20 2a 2a 20 66 69 6c  rom the.  ** fil
4b00: 65 2d 73 79 73 74 65 6d 2e 0a 20 20 2a 2f 0a 20  e-system..  */. 
4b10: 20 70 42 61 73 65 20 3d 20 70 2d 3e 70 42 61 73   pBase = p->pBas
4b20: 65 52 65 61 64 3b 0a 20 20 69 66 28 20 70 42 61  eRead;.  if( pBa
4b30: 73 65 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b 0a  se->pMethods ){.
4b40: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
4b50: 4f 73 46 69 6c 65 53 69 7a 65 28 70 42 61 73 65  OsFileSize(pBase
4b60: 2c 20 26 73 29 3b 0a 20 20 7d 0a 0a 20 20 69 66  , &s);.  }..  if
4b70: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
4b80: 29 7b 0a 20 20 20 20 41 73 79 6e 63 57 72 69 74  ){.    AsyncWrit
4b90: 65 20 2a 70 57 72 69 74 65 3b 0a 20 20 20 20 66  e *pWrite;.    f
4ba0: 6f 72 28 70 57 72 69 74 65 3d 61 73 79 6e 63 2e  or(pWrite=async.
4bb0: 70 51 75 65 75 65 46 69 72 73 74 3b 20 70 57 72  pQueueFirst; pWr
4bc0: 69 74 65 3b 20 70 57 72 69 74 65 20 3d 20 70 57  ite; pWrite = pW
4bd0: 72 69 74 65 2d 3e 70 4e 65 78 74 29 7b 0a 20 20  rite->pNext){.  
4be0: 20 20 20 20 69 66 28 20 70 57 72 69 74 65 2d 3e      if( pWrite->
4bf0: 70 46 69 6c 65 44 61 74 61 3d 3d 70 20 29 7b 0a  pFileData==p ){.
4c00: 20 20 20 20 20 20 20 20 73 77 69 74 63 68 28 20          switch( 
4c10: 70 57 72 69 74 65 2d 3e 6f 70 20 29 7b 0a 20 20  pWrite->op ){.  
4c20: 20 20 20 20 20 20 20 20 63 61 73 65 20 41 53 59          case ASY
4c30: 4e 43 5f 57 52 49 54 45 3a 0a 20 20 20 20 20 20  NC_WRITE:.      
4c40: 20 20 20 20 20 20 73 20 3d 20 4d 41 58 28 70 57        s = MAX(pW
4c50: 72 69 74 65 2d 3e 69 4f 66 66 73 65 74 20 2b 20  rite->iOffset + 
4c60: 28 69 36 34 29 28 70 57 72 69 74 65 2d 3e 6e 42  (i64)(pWrite->nB
4c70: 79 74 65 29 2c 20 73 29 3b 0a 20 20 20 20 20 20  yte), s);.      
4c80: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
4c90: 20 20 20 20 20 20 20 63 61 73 65 20 41 53 59 4e         case ASYN
4ca0: 43 5f 54 52 55 4e 43 41 54 45 3a 0a 20 20 20 20  C_TRUNCATE:.    
4cb0: 20 20 20 20 20 20 20 20 73 20 3d 20 4d 49 4e 28          s = MIN(
4cc0: 73 2c 20 70 57 72 69 74 65 2d 3e 69 4f 66 66 73  s, pWrite->iOffs
4cd0: 65 74 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20  et);.           
4ce0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20   break;.        
4cf0: 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  }.      }.    }.
4d00: 20 20 20 20 2a 70 69 53 69 7a 65 20 3d 20 73 3b      *piSize = s;
4d10: 0a 20 20 7d 0a 20 20 70 74 68 72 65 61 64 5f 6d  .  }.  pthread_m
4d20: 75 74 65 78 5f 75 6e 6c 6f 63 6b 28 26 61 73 79  utex_unlock(&asy
4d30: 6e 63 2e 71 75 65 75 65 4d 75 74 65 78 29 3b 0a  nc.queueMutex);.
4d40: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
4d50: 2f 2a 0a 2a 2a 20 4e 6f 20 64 69 73 6b 20 6c 6f  /*.** No disk lo
4d60: 63 6b 69 6e 67 20 69 73 20 70 65 72 66 6f 72 6d  cking is perform
4d70: 65 64 2e 20 20 57 65 20 6b 65 65 70 20 74 72 61  ed.  We keep tra
4d80: 63 6b 20 6f 66 20 6c 6f 63 6b 73 20 6c 6f 63 61  ck of locks loca
4d90: 6c 6c 79 20 69 6e 0a 2a 2a 20 74 68 65 20 61 73  lly in.** the as
4da0: 79 6e 63 2e 61 4c 6f 63 6b 20 68 61 73 68 20 74  ync.aLock hash t
4db0: 61 62 6c 65 2e 20 20 4c 6f 63 6b 69 6e 67 20 73  able.  Locking s
4dc0: 68 6f 75 6c 64 20 61 70 70 65 61 72 20 74 6f 20  hould appear to 
4dd0: 77 6f 72 6b 20 74 68 65 20 73 61 6d 65 0a 2a 2a  work the same.**
4de0: 20 61 73 20 77 69 74 68 20 73 74 61 6e 64 61 72   as with standar
4df0: 64 20 28 75 6e 6d 6f 64 69 66 69 65 64 29 20 53  d (unmodified) S
4e00: 51 4c 69 74 65 20 61 73 20 6c 6f 6e 67 20 61 73  QLite as long as
4e10: 20 61 6c 6c 20 63 6f 6e 6e 65 63 74 69 6f 6e 73   all connections
4e20: 20 0a 2a 2a 20 63 6f 6d 65 20 66 72 6f 6d 20 74   .** come from t
4e30: 68 69 73 20 6f 6e 65 20 70 72 6f 63 65 73 73 2e  his one process.
4e40: 20 20 43 6f 6e 6e 65 63 74 69 6f 6e 73 20 66 72    Connections fr
4e50: 6f 6d 20 65 78 74 65 72 6e 61 6c 20 70 72 6f 63  om external proc
4e60: 65 73 73 65 73 0a 2a 2a 20 63 61 6e 6e 6f 74 20  esses.** cannot 
4e70: 73 65 65 20 6f 75 72 20 69 6e 74 65 72 6e 61 6c  see our internal
4e80: 20 68 61 73 68 20 74 61 62 6c 65 20 28 6f 62 76   hash table (obv
4e90: 69 6f 75 73 6c 79 29 20 61 6e 64 20 77 69 6c 6c  iously) and will
4ea0: 20 74 68 75 73 20 6e 6f 74 0a 2a 2a 20 68 6f 6e   thus not.** hon
4eb0: 6f 72 20 6f 75 72 20 6c 6f 63 6b 73 2e 0a 2a 2f  or our locks..*/
4ec0: 0a 73 74 61 74 69 63 20 69 6e 74 20 61 73 79 6e  .static int asyn
4ed0: 63 4c 6f 63 6b 28 73 71 6c 69 74 65 33 5f 66 69  cLock(sqlite3_fi
4ee0: 6c 65 20 2a 70 46 69 6c 65 2c 20 69 6e 74 20 6c  le *pFile, int l
4ef0: 6f 63 6b 54 79 70 65 29 7b 0a 20 20 41 73 79 6e  ockType){.  Asyn
4f00: 63 46 69 6c 65 44 61 74 61 20 2a 70 20 3d 20 28  cFileData *p = (
4f10: 28 41 73 79 6e 63 46 69 6c 65 20 2a 29 70 46 69  (AsyncFile *)pFi
4f20: 6c 65 29 2d 3e 70 44 61 74 61 3b 0a 20 20 41 53  le)->pData;.  AS
4f30: 59 4e 43 5f 54 52 41 43 45 28 28 22 4c 4f 43 4b  YNC_TRACE(("LOCK
4f40: 20 25 64 20 28 25 73 29 5c 6e 22 2c 20 6c 6f 63   %d (%s)\n", loc
4f50: 6b 54 79 70 65 2c 20 70 2d 3e 7a 4e 61 6d 65 29  kType, p->zName)
4f60: 29 3b 0a 20 20 70 74 68 72 65 61 64 5f 6d 75 74  );.  pthread_mut
4f70: 65 78 5f 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 6c  ex_lock(&async.l
4f80: 6f 63 6b 4d 75 74 65 78 29 3b 0a 20 20 73 71 6c  ockMutex);.  sql
4f90: 69 74 65 33 48 61 73 68 49 6e 73 65 72 74 28 26  ite3HashInsert(&
4fa0: 61 73 79 6e 63 2e 61 4c 6f 63 6b 2c 20 70 2d 3e  async.aLock, p->
4fb0: 7a 4e 61 6d 65 2c 20 70 2d 3e 6e 4e 61 6d 65 2c  zName, p->nName,
4fc0: 20 28 76 6f 69 64 2a 29 6c 6f 63 6b 54 79 70 65   (void*)lockType
4fd0: 29 3b 0a 20 20 70 74 68 72 65 61 64 5f 6d 75 74  );.  pthread_mut
4fe0: 65 78 5f 75 6e 6c 6f 63 6b 28 26 61 73 79 6e 63  ex_unlock(&async
4ff0: 2e 6c 6f 63 6b 4d 75 74 65 78 29 3b 0a 20 20 72  .lockMutex);.  r
5000: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
5010: 0a 7d 0a 73 74 61 74 69 63 20 69 6e 74 20 61 73  .}.static int as
5020: 79 6e 63 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 65  yncUnlock(sqlite
5030: 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 69  3_file *pFile, i
5040: 6e 74 20 6c 6f 63 6b 54 79 70 65 29 7b 0a 20 20  nt lockType){.  
5050: 72 65 74 75 72 6e 20 61 73 79 6e 63 4c 6f 63 6b  return asyncLock
5060: 28 70 46 69 6c 65 2c 20 6c 6f 63 6b 54 79 70 65  (pFile, lockType
5070: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  );.}../*.** This
5080: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
5090: 6c 65 64 20 77 68 65 6e 20 74 68 65 20 70 61 67  led when the pag
50a0: 65 72 20 6c 61 79 65 72 20 66 69 72 73 74 20 6f  er layer first o
50b0: 70 65 6e 73 20 61 20 64 61 74 61 62 61 73 65 20  pens a database 
50c0: 66 69 6c 65 0a 2a 2a 20 61 6e 64 20 69 73 20 63  file.** and is c
50d0: 68 65 63 6b 69 6e 67 20 66 6f 72 20 61 20 68 6f  hecking for a ho
50e0: 74 2d 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a 73 74  t-journal..*/.st
50f0: 61 74 69 63 20 69 6e 74 20 61 73 79 6e 63 43 68  atic int asyncCh
5100: 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 28  eckReservedLock(
5110: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46  sqlite3_file *pF
5120: 69 6c 65 29 7b 0a 20 20 41 73 79 6e 63 46 69 6c  ile){.  AsyncFil
5130: 65 44 61 74 61 20 2a 70 20 3d 20 28 28 41 73 79  eData *p = ((Asy
5140: 6e 63 46 69 6c 65 20 2a 29 70 46 69 6c 65 29 2d  ncFile *)pFile)-
5150: 3e 70 44 61 74 61 3b 0a 20 20 69 6e 74 20 72 63  >pData;.  int rc
5160: 3b 0a 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65  ;.  pthread_mute
5170: 78 5f 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 6c 6f  x_lock(&async.lo
5180: 63 6b 4d 75 74 65 78 29 3b 0a 20 20 72 63 20 3d  ckMutex);.  rc =
5190: 20 28 69 6e 74 29 73 71 6c 69 74 65 33 48 61 73   (int)sqlite3Has
51a0: 68 46 69 6e 64 28 26 61 73 79 6e 63 2e 61 4c 6f  hFind(&async.aLo
51b0: 63 6b 2c 20 70 2d 3e 7a 4e 61 6d 65 2c 20 70 2d  ck, p->zName, p-
51c0: 3e 6e 4e 61 6d 65 29 3b 0a 20 20 70 74 68 72 65  >nName);.  pthre
51d0: 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f 63 6b 28  ad_mutex_unlock(
51e0: 26 61 73 79 6e 63 2e 6c 6f 63 6b 4d 75 74 65 78  &async.lockMutex
51f0: 29 3b 0a 20 20 41 53 59 4e 43 5f 54 52 41 43 45  );.  ASYNC_TRACE
5200: 28 28 22 43 48 45 43 4b 2d 4c 4f 43 4b 20 25 64  (("CHECK-LOCK %d
5210: 20 28 25 73 29 5c 6e 22 2c 20 72 63 2c 20 70 2d   (%s)\n", rc, p-
5220: 3e 7a 4e 61 6d 65 29 29 3b 0a 20 20 72 65 74 75  >zName));.  retu
5230: 72 6e 20 72 63 3e 53 48 41 52 45 44 5f 4c 4f 43  rn rc>SHARED_LOC
5240: 4b 3b 0a 7d 0a 0a 2f 2a 20 0a 2a 2a 20 54 68 69  K;.}../* .** Thi
5250: 73 20 69 73 20 61 20 6e 6f 2d 6f 70 2c 20 61 73  s is a no-op, as
5260: 20 74 68 65 20 61 73 79 6e 63 68 72 6f 6e 6f 75   the asynchronou
5270: 73 20 62 61 63 6b 65 6e 64 20 64 6f 65 73 20 6e  s backend does n
5280: 6f 74 20 73 75 70 70 6f 72 74 20 6c 6f 63 6b 69  ot support locki
5290: 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ng..*/.static in
52a0: 74 20 61 73 79 6e 63 42 72 65 61 6b 4c 6f 63 6b  t asyncBreakLock
52b0: 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 69  (sqlite3_file *i
52c0: 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  d){.  return SQL
52d0: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 20 0a 2a  ITE_OK;.}../* .*
52e0: 2a 20 54 68 69 73 20 69 73 20 62 72 6f 6b 65 6e  * This is broken
52f0: 2e 20 42 75 74 20 73 71 6c 69 74 65 33 4f 73 4c  . But sqlite3OsL
5300: 6f 63 6b 53 74 61 74 65 28 29 20 69 73 20 6f 6e  ockState() is on
5310: 6c 79 20 75 73 65 64 20 66 6f 72 20 74 65 73 74  ly used for test
5320: 69 6e 67 20 61 6e 79 77 61 79 2e 0a 2a 2f 0a 73  ing anyway..*/.s
5330: 74 61 74 69 63 20 69 6e 74 20 61 73 79 6e 63 4c  tatic int asyncL
5340: 6f 63 6b 53 74 61 74 65 28 73 71 6c 69 74 65 33  ockState(sqlite3
5350: 5f 66 69 6c 65 20 2a 69 64 29 7b 0a 20 20 72 65  _file *id){.  re
5360: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
5370: 7d 0a 0a 2f 2a 20 0a 2a 2a 20 52 65 74 75 72 6e  }../* .** Return
5380: 20 74 68 65 20 64 65 76 69 63 65 20 63 68 61 72   the device char
5390: 61 63 74 65 72 69 73 74 69 63 73 20 61 6e 64 20  acteristics and 
53a0: 73 65 63 74 6f 72 2d 73 69 7a 65 20 6f 66 20 74  sector-size of t
53b0: 68 65 20 64 65 76 69 63 65 2e 20 49 74 0a 2a 2a  he device. It.**
53c0: 20 69 73 20 6e 6f 74 20 74 72 69 63 6b 79 20 74   is not tricky t
53d0: 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 73  o implement thes
53e0: 65 20 63 6f 72 72 65 63 74 6c 79 2c 20 61 73 20  e correctly, as 
53f0: 74 68 69 73 20 62 61 63 6b 65 6e 64 20 6d 69 67  this backend mig
5400: 68 74 20 0a 2a 2a 20 6e 6f 74 20 68 61 76 65 20  ht .** not have 
5410: 61 6e 20 6f 70 65 6e 20 66 69 6c 65 20 68 61 6e  an open file han
5420: 64 6c 65 20 61 74 20 74 68 69 73 20 70 6f 69 6e  dle at this poin
5430: 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  t..*/.static int
5440: 20 61 73 79 6e 63 53 65 63 74 6f 72 53 69 7a 65   asyncSectorSize
5450: 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70  (sqlite3_file *p
5460: 46 69 6c 65 29 7b 0a 20 20 72 65 74 75 72 6e 20  File){.  return 
5470: 35 31 32 3b 0a 7d 0a 73 74 61 74 69 63 20 69 6e  512;.}.static in
5480: 74 20 61 73 79 6e 63 44 65 76 69 63 65 43 68 61  t asyncDeviceCha
5490: 72 61 63 74 65 72 69 73 74 69 63 73 28 73 71 6c  racteristics(sql
54a0: 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65  ite3_file *pFile
54b0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d  ){.  return 0;.}
54c0: 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 66  ../*.** Open a f
54d0: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
54e0: 6e 74 20 61 73 79 6e 63 4f 70 65 6e 28 0a 20 20  nt asyncOpen(.  
54f0: 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 41 73  sqlite3_vfs *pAs
5500: 79 6e 63 56 66 73 2c 0a 20 20 63 6f 6e 73 74 20  yncVfs,.  const 
5510: 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 0a 20 20 73  char *zName,.  s
5520: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69  qlite3_file *pFi
5530: 6c 65 2c 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c  le,.  int flags,
5540: 0a 20 20 69 6e 74 20 2a 70 4f 75 74 46 6c 61 67  .  int *pOutFlag
5550: 73 0a 29 7b 0a 20 20 73 74 61 74 69 63 20 73 71  s.){.  static sq
5560: 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64 73  lite3_io_methods
5570: 20 61 73 79 6e 63 5f 6d 65 74 68 6f 64 73 20 3d   async_methods =
5580: 20 7b 0a 20 20 20 20 31 2c 20 20 20 20 20 20 20   {.    1,       
5590: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
55a0: 20 20 20 20 20 20 20 20 2f 2a 20 69 56 65 72 73          /* iVers
55b0: 69 6f 6e 20 2a 2f 0a 20 20 20 20 61 73 79 6e 63  ion */.    async
55c0: 43 6c 6f 73 65 2c 20 20 20 20 20 20 20 20 20 20  Close,          
55d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
55e0: 43 6c 6f 73 65 20 2a 2f 0a 20 20 20 20 61 73 79  Close */.    asy
55f0: 6e 63 52 65 61 64 2c 20 20 20 20 20 20 20 20 20  ncRead,         
5600: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
5610: 20 78 52 65 61 64 20 2a 2f 0a 20 20 20 20 61 73   xRead */.    as
5620: 79 6e 63 57 72 69 74 65 2c 20 20 20 20 20 20 20  yncWrite,       
5630: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5640: 2a 20 78 57 72 69 74 65 20 2a 2f 0a 20 20 20 20  * xWrite */.    
5650: 61 73 79 6e 63 54 72 75 6e 63 61 74 65 2c 20 20  asyncTruncate,  
5660: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5670: 20 2f 2a 20 78 54 72 75 6e 63 61 74 65 20 2a 2f   /* xTruncate */
5680: 0a 20 20 20 20 61 73 79 6e 63 53 79 6e 63 2c 20  .    asyncSync, 
5690: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
56a0: 20 20 20 20 20 20 2f 2a 20 78 53 79 6e 63 20 2a        /* xSync *
56b0: 2f 0a 20 20 20 20 61 73 79 6e 63 46 69 6c 65 53  /.    asyncFileS
56c0: 69 7a 65 2c 20 20 20 20 20 20 20 20 20 20 20 20  ize,            
56d0: 20 20 20 20 20 20 20 2f 2a 20 78 46 69 6c 65 53         /* xFileS
56e0: 69 7a 65 20 2a 2f 0a 20 20 20 20 61 73 79 6e 63  ize */.    async
56f0: 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20 20  Lock,           
5700: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
5710: 4c 6f 63 6b 20 2a 2f 0a 20 20 20 20 61 73 79 6e  Lock */.    asyn
5720: 63 55 6e 6c 6f 63 6b 2c 20 20 20 20 20 20 20 20  cUnlock,        
5730: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5740: 78 55 6e 6c 6f 63 6b 20 2a 2f 0a 20 20 20 20 61  xUnlock */.    a
5750: 73 79 6e 63 43 68 65 63 6b 52 65 73 65 72 76 65  syncCheckReserve
5760: 64 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20  dLock,          
5770: 2f 2a 20 78 43 68 65 63 6b 52 65 73 65 72 76 65  /* xCheckReserve
5780: 64 4c 6f 63 6b 20 2a 2f 0a 20 20 20 20 61 73 79  dLock */.    asy
5790: 6e 63 42 72 65 61 6b 4c 6f 63 6b 2c 20 20 20 20  ncBreakLock,    
57a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
57b0: 20 78 42 72 65 61 6b 4c 6f 63 6b 20 2a 2f 0a 20   xBreakLock */. 
57c0: 20 20 20 61 73 79 6e 63 4c 6f 63 6b 53 74 61 74     asyncLockStat
57d0: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e,              
57e0: 20 20 20 20 2f 2a 20 78 4c 6f 63 6b 53 74 61 74      /* xLockStat
57f0: 65 20 2a 2f 0a 20 20 20 20 61 73 79 6e 63 53 65  e */.    asyncSe
5800: 63 74 6f 72 53 69 7a 65 2c 20 20 20 20 20 20 20  ctorSize,       
5810: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 53 65            /* xSe
5820: 63 74 6f 72 53 69 7a 65 20 2a 2f 0a 20 20 20 20  ctorSize */.    
5830: 61 73 79 6e 63 44 65 76 69 63 65 43 68 61 72 61  asyncDeviceChara
5840: 63 74 65 72 69 73 74 69 63 73 20 20 20 20 20 20  cteristics      
5850: 20 2f 2a 20 78 44 65 76 69 63 65 43 68 61 72 61   /* xDeviceChara
5860: 63 74 65 72 69 73 74 69 63 73 20 2a 2f 0a 20 20  cteristics */.  
5870: 7d 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 76 66  };..  sqlite3_vf
5880: 73 20 2a 70 56 66 73 20 3d 20 28 73 71 6c 69 74  s *pVfs = (sqlit
5890: 65 33 5f 76 66 73 20 2a 29 70 41 73 79 6e 63 56  e3_vfs *)pAsyncV
58a0: 66 73 2d 3e 70 41 70 70 44 61 74 61 3b 0a 20 20  fs->pAppData;.  
58b0: 41 73 79 6e 63 46 69 6c 65 20 2a 70 20 3d 20 28  AsyncFile *p = (
58c0: 41 73 79 6e 63 46 69 6c 65 20 2a 29 70 46 69 6c  AsyncFile *)pFil
58d0: 65 3b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 20 3d  e;.  int nName =
58e0: 20 73 74 72 6c 65 6e 28 7a 4e 61 6d 65 29 3b 3b   strlen(zName);;
58f0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74  .  int rc;.  int
5900: 20 6e 42 79 74 65 3b 0a 20 20 41 73 79 6e 63 46   nByte;.  AsyncF
5910: 69 6c 65 44 61 74 61 20 2a 70 44 61 74 61 3b 0a  ileData *pData;.
5920: 0a 20 20 6e 42 79 74 65 20 3d 20 28 0a 20 20 20  .  nByte = (.   
5930: 20 73 69 7a 65 6f 66 28 41 73 79 6e 63 46 69 6c   sizeof(AsyncFil
5940: 65 44 61 74 61 29 20 2b 20 20 20 20 20 20 20 20  eData) +        
5950: 2f 2a 20 41 73 79 6e 63 46 69 6c 65 44 61 74 61  /* AsyncFileData
5960: 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20   structure */.  
5970: 20 20 32 20 2a 20 70 56 66 73 2d 3e 73 7a 4f 73    2 * pVfs->szOs
5980: 46 69 6c 65 20 2b 20 20 20 20 20 20 20 20 20 20  File +          
5990: 20 2f 2a 20 41 73 79 6e 63 46 69 6c 65 44 61 74   /* AsyncFileDat
59a0: 61 2e 7a 4e 61 6d 65 20 2a 2f 0a 20 20 20 20 6e  a.zName */.    n
59b0: 4e 61 6d 65 20 2b 20 31 20 20 20 20 20 20 20 20  Name + 1        
59c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
59d0: 20 41 73 79 6e 63 46 69 6c 65 44 61 74 61 2e 70   AsyncFileData.p
59e0: 42 61 73 65 52 65 61 64 20 61 6e 64 20 70 42 61  BaseRead and pBa
59f0: 73 65 57 72 69 74 65 20 2a 2f 0a 20 20 29 3b 0a  seWrite */.  );.
5a00: 20 20 70 44 61 74 61 20 3d 20 73 71 6c 69 74 65    pData = sqlite
5a10: 33 5f 6d 61 6c 6c 6f 63 28 6e 42 79 74 65 29 3b  3_malloc(nByte);
5a20: 0a 20 20 69 66 28 20 21 70 44 61 74 61 20 29 7b  .  if( !pData ){
5a30: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
5a40: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20  TE_NOMEM;.  }.  
5a50: 6d 65 6d 73 65 74 28 70 44 61 74 61 2c 20 30 2c  memset(pData, 0,
5a60: 20 6e 42 79 74 65 29 3b 0a 20 20 70 44 61 74 61   nByte);.  pData
5a70: 2d 3e 7a 4e 61 6d 65 20 3d 20 28 63 68 61 72 20  ->zName = (char 
5a80: 2a 29 26 70 44 61 74 61 5b 31 5d 3b 0a 20 20 70  *)&pData[1];.  p
5a90: 44 61 74 61 2d 3e 6e 4e 61 6d 65 20 3d 20 6e 4e  Data->nName = nN
5aa0: 61 6d 65 3b 0a 20 20 70 44 61 74 61 2d 3e 70 42  ame;.  pData->pB
5ab0: 61 73 65 52 65 61 64 20 3d 20 28 73 71 6c 69 74  aseRead = (sqlit
5ac0: 65 33 5f 66 69 6c 65 20 2a 29 26 70 44 61 74 61  e3_file *)&pData
5ad0: 2d 3e 7a 4e 61 6d 65 5b 6e 4e 61 6d 65 2b 31 5d  ->zName[nName+1]
5ae0: 3b 0a 20 20 70 44 61 74 61 2d 3e 70 42 61 73 65  ;.  pData->pBase
5af0: 57 72 69 74 65 20 3d 20 28 73 71 6c 69 74 65 33  Write = (sqlite3
5b00: 5f 66 69 6c 65 20 2a 29 26 70 44 61 74 61 2d 3e  _file *)&pData->
5b10: 7a 4e 61 6d 65 5b 6e 4e 61 6d 65 2b 31 2b 70 56  zName[nName+1+pV
5b20: 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 5d 3b 0a 20  fs->szOsFile];. 
5b30: 20 6d 65 6d 63 70 79 28 70 44 61 74 61 2d 3e 7a   memcpy(pData->z
5b40: 4e 61 6d 65 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61  Name, zName, nNa
5b50: 6d 65 2b 31 29 3b 0a 0a 20 20 69 66 28 20 66 6c  me+1);..  if( fl
5b60: 61 67 73 26 53 51 4c 49 54 45 5f 4f 50 45 4e 5f  ags&SQLITE_OPEN_
5b70: 45 58 43 4c 55 53 49 56 45 20 29 7b 0a 20 20 20  EXCLUSIVE ){.   
5b80: 20 72 63 20 3d 20 61 64 64 4e 65 77 41 73 79 6e   rc = addNewAsyn
5b90: 63 57 72 69 74 65 28 70 44 61 74 61 2c 20 41 53  cWrite(pData, AS
5ba0: 59 4e 43 5f 4f 50 45 4e 45 58 43 4c 55 53 49 56  YNC_OPENEXCLUSIV
5bb0: 45 2c 20 28 69 36 34 29 66 6c 61 67 73 2c 20 30  E, (i64)flags, 0
5bc0: 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20 70 4f  , 0);.    if( pO
5bd0: 75 74 46 6c 61 67 73 20 29 20 2a 70 4f 75 74 46  utFlags ) *pOutF
5be0: 6c 61 67 73 20 3d 20 66 6c 61 67 73 3b 0a 20 20  lags = flags;.  
5bf0: 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20  }else{.    rc = 
5c00: 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 28 70 56  sqlite3OsOpen(pV
5c10: 66 73 2c 20 7a 4e 61 6d 65 2c 20 70 44 61 74 61  fs, zName, pData
5c20: 2d 3e 70 42 61 73 65 52 65 61 64 2c 20 66 6c 61  ->pBaseRead, fla
5c30: 67 73 2c 20 70 4f 75 74 46 6c 61 67 73 29 3b 0a  gs, pOutFlags);.
5c40: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
5c50: 54 45 5f 4f 4b 20 26 26 20 28 28 2a 70 4f 75 74  TE_OK && ((*pOut
5c60: 46 6c 61 67 73 29 26 53 51 4c 49 54 45 5f 4f 50  Flags)&SQLITE_OP
5c70: 45 4e 5f 52 45 41 44 57 52 49 54 45 29 20 29 7b  EN_READWRITE) ){
5c80: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69  .      rc = sqli
5c90: 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20  te3OsOpen(pVfs, 
5ca0: 7a 4e 61 6d 65 2c 20 70 44 61 74 61 2d 3e 70 42  zName, pData->pB
5cb0: 61 73 65 57 72 69 74 65 2c 20 66 6c 61 67 73 2c  aseWrite, flags,
5cc0: 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a   0);.    }.  }..
5cd0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
5ce0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 70 2d 3e 70 4d  _OK ){.    p->pM
5cf0: 65 74 68 6f 64 20 3d 20 26 61 73 79 6e 63 5f 6d  ethod = &async_m
5d00: 65 74 68 6f 64 73 3b 0a 20 20 20 20 70 2d 3e 70  ethods;.    p->p
5d10: 44 61 74 61 20 3d 20 70 44 61 74 61 3b 0a 20 20  Data = pData;.  
5d20: 20 20 69 6e 63 72 4f 70 65 6e 46 69 6c 65 43 6f    incrOpenFileCo
5d30: 75 6e 74 28 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a  unt();.  }else{.
5d40: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f      sqlite3OsClo
5d50: 73 65 28 70 44 61 74 61 2d 3e 70 42 61 73 65 52  se(pData->pBaseR
5d60: 65 61 64 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  ead);.    sqlite
5d70: 33 4f 73 43 6c 6f 73 65 28 70 44 61 74 61 2d 3e  3OsClose(pData->
5d80: 70 42 61 73 65 57 72 69 74 65 29 3b 0a 20 20 20  pBaseWrite);.   
5d90: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 44   sqlite3_free(pD
5da0: 61 74 61 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74  ata);.  }..  ret
5db0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
5dc0: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   Implementation 
5dd0: 6f 66 20 73 71 6c 69 74 65 33 4f 73 44 65 6c 65  of sqlite3OsDele
5de0: 74 65 2e 20 41 64 64 20 61 6e 20 65 6e 74 72 79  te. Add an entry
5df0: 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 74   to the end of t
5e00: 68 65 20 0a 2a 2a 20 77 72 69 74 65 2d 6f 70 20  he .** write-op 
5e10: 71 75 65 75 65 20 74 6f 20 70 65 72 66 6f 72 6d  queue to perform
5e20: 20 74 68 65 20 64 65 6c 65 74 65 2e 0a 2a 2f 0a   the delete..*/.
5e30: 73 74 61 74 69 63 20 69 6e 74 20 61 73 79 6e 63  static int async
5e40: 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 5f 76  Delete(sqlite3_v
5e50: 66 73 20 2a 70 41 73 79 6e 63 56 66 73 2c 20 63  fs *pAsyncVfs, c
5e60: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e  onst char *z, in
5e70: 74 20 73 79 6e 63 44 69 72 29 7b 0a 20 20 72 65  t syncDir){.  re
5e80: 74 75 72 6e 20 61 64 64 4e 65 77 41 73 79 6e 63  turn addNewAsync
5e90: 57 72 69 74 65 28 30 2c 20 41 53 59 4e 43 5f 44  Write(0, ASYNC_D
5ea0: 45 4c 45 54 45 2c 20 73 79 6e 63 44 69 72 2c 20  ELETE, syncDir, 
5eb0: 73 74 72 6c 65 6e 28 7a 29 2b 31 2c 20 7a 29 3b  strlen(z)+1, z);
5ec0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d  .}../*.** Implem
5ed0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 73 71 6c 69  entation of sqli
5ee0: 74 65 33 4f 73 41 63 63 65 73 73 2e 20 54 68 69  te3OsAccess. Thi
5ef0: 73 20 6d 65 74 68 6f 64 20 68 6f 6c 64 73 20 74  s method holds t
5f00: 68 65 20 6d 75 74 65 78 20 66 72 6f 6d 0a 2a 2a  he mutex from.**
5f10: 20 73 74 61 72 74 20 74 6f 20 66 69 6e 69 73 68   start to finish
5f20: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
5f30: 61 73 79 6e 63 41 63 63 65 73 73 28 73 71 6c 69  asyncAccess(sqli
5f40: 74 65 33 5f 76 66 73 20 2a 70 41 73 79 6e 63 56  te3_vfs *pAsyncV
5f50: 66 73 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  fs, const char *
5f60: 7a 4e 61 6d 65 2c 20 69 6e 74 20 66 6c 61 67 73  zName, int flags
5f70: 29 7b 0a 20 20 69 6e 74 20 72 65 74 3b 0a 20 20  ){.  int ret;.  
5f80: 41 73 79 6e 63 57 72 69 74 65 20 2a 70 3b 0a 20  AsyncWrite *p;. 
5f90: 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56   sqlite3_vfs *pV
5fa0: 66 73 20 3d 20 28 73 71 6c 69 74 65 33 5f 76 66  fs = (sqlite3_vf
5fb0: 73 20 2a 29 70 41 73 79 6e 63 56 66 73 2d 3e 70  s *)pAsyncVfs->p
5fc0: 41 70 70 44 61 74 61 3b 0a 0a 20 20 61 73 73 65  AppData;..  asse
5fd0: 72 74 28 66 6c 61 67 73 3d 3d 53 51 4c 49 54 45  rt(flags==SQLITE
5fe0: 5f 41 43 43 45 53 53 5f 52 45 41 44 57 52 49 54  _ACCESS_READWRIT
5ff0: 45 20 0a 20 20 20 20 20 20 7c 7c 20 66 6c 61 67  E .      || flag
6000: 73 3d 3d 53 51 4c 49 54 45 5f 41 43 43 45 53 53  s==SQLITE_ACCESS
6010: 5f 52 45 41 44 20 0a 20 20 20 20 20 20 7c 7c 20  _READ .      || 
6020: 66 6c 61 67 73 3d 3d 53 51 4c 49 54 45 5f 41 43  flags==SQLITE_AC
6030: 43 45 53 53 5f 45 58 49 53 54 53 20 0a 20 20 29  CESS_EXISTS .  )
6040: 3b 0a 0a 20 20 70 74 68 72 65 61 64 5f 6d 75 74  ;..  pthread_mut
6050: 65 78 5f 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 71  ex_lock(&async.q
6060: 75 65 75 65 4d 75 74 65 78 29 3b 0a 20 20 72 65  ueueMutex);.  re
6070: 74 20 3d 20 73 71 6c 69 74 65 33 4f 73 41 63 63  t = sqlite3OsAcc
6080: 65 73 73 28 70 56 66 73 2c 20 7a 4e 61 6d 65 2c  ess(pVfs, zName,
6090: 20 66 6c 61 67 73 29 3b 0a 20 20 69 66 28 20 66   flags);.  if( f
60a0: 6c 61 67 73 3d 3d 53 51 4c 49 54 45 5f 41 43 43  lags==SQLITE_ACC
60b0: 45 53 53 5f 45 58 49 53 54 53 20 29 7b 0a 20 20  ESS_EXISTS ){.  
60c0: 20 20 66 6f 72 28 70 3d 61 73 79 6e 63 2e 70 51    for(p=async.pQ
60d0: 75 65 75 65 46 69 72 73 74 3b 20 70 3b 20 70 20  ueueFirst; p; p 
60e0: 3d 20 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20  = p->pNext){.   
60f0: 20 20 20 69 66 28 20 70 2d 3e 6f 70 3d 3d 41 53     if( p->op==AS
6100: 59 4e 43 5f 44 45 4c 45 54 45 20 26 26 20 30 3d  YNC_DELETE && 0=
6110: 3d 73 74 72 63 6d 70 28 70 2d 3e 7a 42 75 66 2c  =strcmp(p->zBuf,
6120: 20 7a 4e 61 6d 65 29 20 29 7b 0a 20 20 20 20 20   zName) ){.     
6130: 20 20 20 72 65 74 20 3d 20 30 3b 0a 20 20 20 20     ret = 0;.    
6140: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 6f    }else if( p->o
6150: 70 3d 3d 41 53 59 4e 43 5f 4f 50 45 4e 45 58 43  p==ASYNC_OPENEXC
6160: 4c 55 53 49 56 45 20 0a 20 20 20 20 20 20 20 20  LUSIVE .        
6170: 20 20 20 20 20 26 26 20 30 3d 3d 73 74 72 63 6d       && 0==strcm
6180: 70 28 70 2d 3e 70 46 69 6c 65 44 61 74 61 2d 3e  p(p->pFileData->
6190: 7a 4e 61 6d 65 2c 20 7a 4e 61 6d 65 29 20 0a 20  zName, zName) . 
61a0: 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20       ){.        
61b0: 72 65 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d  ret = 1;.      }
61c0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 41 53 59  .    }.  }.  ASY
61d0: 4e 43 5f 54 52 41 43 45 28 28 22 41 43 43 45 53  NC_TRACE(("ACCES
61e0: 53 28 25 73 29 3a 20 25 73 20 3d 20 25 64 5c 6e  S(%s): %s = %d\n
61f0: 22 2c 20 0a 20 20 20 20 66 6c 61 67 73 3d 3d 53  ", .    flags==S
6200: 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 52 45 41  QLITE_ACCESS_REA
6210: 44 57 52 49 54 45 3f 22 72 65 61 64 2d 77 72 69  DWRITE?"read-wri
6220: 74 65 22 3a 0a 20 20 20 20 66 6c 61 67 73 3d 3d  te":.    flags==
6230: 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 52 45  SQLITE_ACCESS_RE
6240: 41 44 3f 22 72 65 61 64 22 3a 22 65 78 69 73 74  AD?"read":"exist
6250: 73 22 0a 20 20 20 20 2c 20 7a 4e 61 6d 65 2c 20  s".    , zName, 
6260: 72 65 74 29 0a 20 20 29 3b 0a 20 20 70 74 68 72  ret).  );.  pthr
6270: 65 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f 63 6b  ead_mutex_unlock
6280: 28 26 61 73 79 6e 63 2e 71 75 65 75 65 4d 75 74  (&async.queueMut
6290: 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 65  ex);.  return re
62a0: 74 3b 0a 7d 0a 0a 73 74 61 74 69 63 20 69 6e 74  t;.}..static int
62b0: 20 61 73 79 6e 63 47 65 74 54 65 6d 70 4e 61 6d   asyncGetTempNam
62c0: 65 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70  e(sqlite3_vfs *p
62d0: 41 73 79 6e 63 56 66 73 2c 20 63 68 61 72 20 2a  AsyncVfs, char *
62e0: 7a 42 75 66 4f 75 74 29 7b 0a 20 20 73 71 6c 69  zBufOut){.  sqli
62f0: 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20  te3_vfs *pVfs = 
6300: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 29 70  (sqlite3_vfs *)p
6310: 41 73 79 6e 63 56 66 73 2d 3e 70 41 70 70 44 61  AsyncVfs->pAppDa
6320: 74 61 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 66  ta;.  return pVf
6330: 73 2d 3e 78 47 65 74 54 65 6d 70 4e 61 6d 65 28  s->xGetTempName(
6340: 70 56 66 73 2c 20 7a 42 75 66 4f 75 74 29 3b 0a  pVfs, zBufOut);.
6350: 7d 0a 73 74 61 74 69 63 20 69 6e 74 20 61 73 79  }.static int asy
6360: 6e 63 46 75 6c 6c 50 61 74 68 6e 61 6d 65 28 0a  ncFullPathname(.
6370: 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70    sqlite3_vfs *p
6380: 41 73 79 6e 63 56 66 73 2c 20 0a 20 20 63 6f 6e  AsyncVfs, .  con
6390: 73 74 20 63 68 61 72 20 2a 7a 50 61 74 68 2c 20  st char *zPath, 
63a0: 0a 20 20 63 68 61 72 20 2a 7a 50 61 74 68 4f 75  .  char *zPathOu
63b0: 74 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76  t.){.  sqlite3_v
63c0: 66 73 20 2a 70 56 66 73 20 3d 20 28 73 71 6c 69  fs *pVfs = (sqli
63d0: 74 65 33 5f 76 66 73 20 2a 29 70 41 73 79 6e 63  te3_vfs *)pAsync
63e0: 56 66 73 2d 3e 70 41 70 70 44 61 74 61 3b 0a 20  Vfs->pAppData;. 
63f0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 4f   return sqlite3O
6400: 73 46 75 6c 6c 50 61 74 68 6e 61 6d 65 28 70 56  sFullPathname(pV
6410: 66 73 2c 20 7a 50 61 74 68 2c 20 7a 50 61 74 68  fs, zPath, zPath
6420: 4f 75 74 29 3b 0a 7d 0a 73 74 61 74 69 63 20 76  Out);.}.static v
6430: 6f 69 64 20 2a 61 73 79 6e 63 44 6c 4f 70 65 6e  oid *asyncDlOpen
6440: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 41  (sqlite3_vfs *pA
6450: 73 79 6e 63 56 66 73 2c 20 63 6f 6e 73 74 20 63  syncVfs, const c
6460: 68 61 72 20 2a 7a 50 61 74 68 29 7b 0a 20 20 73  har *zPath){.  s
6470: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73  qlite3_vfs *pVfs
6480: 20 3d 20 28 73 71 6c 69 74 65 33 5f 76 66 73 20   = (sqlite3_vfs 
6490: 2a 29 70 41 73 79 6e 63 56 66 73 2d 3e 70 41 70  *)pAsyncVfs->pAp
64a0: 70 44 61 74 61 3b 0a 20 20 72 65 74 75 72 6e 20  pData;.  return 
64b0: 70 56 66 73 2d 3e 78 44 6c 4f 70 65 6e 28 70 56  pVfs->xDlOpen(pV
64c0: 66 73 2c 20 7a 50 61 74 68 29 3b 0a 7d 0a 73 74  fs, zPath);.}.st
64d0: 61 74 69 63 20 76 6f 69 64 20 61 73 79 6e 63 44  atic void asyncD
64e0: 6c 45 72 72 6f 72 28 73 71 6c 69 74 65 33 5f 76  lError(sqlite3_v
64f0: 66 73 20 2a 70 41 73 79 6e 63 56 66 73 2c 20 69  fs *pAsyncVfs, i
6500: 6e 74 20 6e 42 79 74 65 2c 20 63 68 61 72 20 2a  nt nByte, char *
6510: 7a 45 72 72 4d 73 67 29 7b 0a 20 20 73 71 6c 69  zErrMsg){.  sqli
6520: 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20  te3_vfs *pVfs = 
6530: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 29 70  (sqlite3_vfs *)p
6540: 41 73 79 6e 63 56 66 73 2d 3e 70 41 70 70 44 61  AsyncVfs->pAppDa
6550: 74 61 3b 0a 20 20 70 56 66 73 2d 3e 78 44 6c 45  ta;.  pVfs->xDlE
6560: 72 72 6f 72 28 70 56 66 73 2c 20 6e 42 79 74 65  rror(pVfs, nByte
6570: 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 7d 0a 73 74  , zErrMsg);.}.st
6580: 61 74 69 63 20 76 6f 69 64 20 2a 61 73 79 6e 63  atic void *async
6590: 44 6c 53 79 6d 28 0a 20 20 73 71 6c 69 74 65 33  DlSym(.  sqlite3
65a0: 5f 76 66 73 20 2a 70 41 73 79 6e 63 56 66 73 2c  _vfs *pAsyncVfs,
65b0: 20 0a 20 20 76 6f 69 64 20 2a 70 48 61 6e 64 6c   .  void *pHandl
65c0: 65 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72  e, .  const char
65d0: 20 2a 7a 53 79 6d 62 6f 6c 0a 29 7b 0a 20 20 73   *zSymbol.){.  s
65e0: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73  qlite3_vfs *pVfs
65f0: 20 3d 20 28 73 71 6c 69 74 65 33 5f 76 66 73 20   = (sqlite3_vfs 
6600: 2a 29 70 41 73 79 6e 63 56 66 73 2d 3e 70 41 70  *)pAsyncVfs->pAp
6610: 70 44 61 74 61 3b 0a 20 20 72 65 74 75 72 6e 20  pData;.  return 
6620: 70 56 66 73 2d 3e 78 44 6c 53 79 6d 28 70 56 66  pVfs->xDlSym(pVf
6630: 73 2c 20 70 48 61 6e 64 6c 65 2c 20 7a 53 79 6d  s, pHandle, zSym
6640: 62 6f 6c 29 3b 0a 7d 0a 73 74 61 74 69 63 20 76  bol);.}.static v
6650: 6f 69 64 20 61 73 79 6e 63 44 6c 43 6c 6f 73 65  oid asyncDlClose
6660: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 41  (sqlite3_vfs *pA
6670: 73 79 6e 63 56 66 73 2c 20 76 6f 69 64 20 2a 70  syncVfs, void *p
6680: 48 61 6e 64 6c 65 29 7b 0a 20 20 73 71 6c 69 74  Handle){.  sqlit
6690: 65 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20 28  e3_vfs *pVfs = (
66a0: 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 29 70 41  sqlite3_vfs *)pA
66b0: 73 79 6e 63 56 66 73 2d 3e 70 41 70 70 44 61 74  syncVfs->pAppDat
66c0: 61 3b 0a 20 20 70 56 66 73 2d 3e 78 44 6c 43 6c  a;.  pVfs->xDlCl
66d0: 6f 73 65 28 70 56 66 73 2c 20 70 48 61 6e 64 6c  ose(pVfs, pHandl
66e0: 65 29 3b 0a 7d 0a 73 74 61 74 69 63 20 69 6e 74  e);.}.static int
66f0: 20 61 73 79 6e 63 52 61 6e 64 6f 6d 6e 65 73 73   asyncRandomness
6700: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 41  (sqlite3_vfs *pA
6710: 73 79 6e 63 56 66 73 2c 20 69 6e 74 20 6e 42 79  syncVfs, int nBy
6720: 74 65 2c 20 63 68 61 72 20 2a 7a 42 75 66 4f 75  te, char *zBufOu
6730: 74 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66  t){.  sqlite3_vf
6740: 73 20 2a 70 56 66 73 20 3d 20 28 73 71 6c 69 74  s *pVfs = (sqlit
6750: 65 33 5f 76 66 73 20 2a 29 70 41 73 79 6e 63 56  e3_vfs *)pAsyncV
6760: 66 73 2d 3e 70 41 70 70 44 61 74 61 3b 0a 20 20  fs->pAppData;.  
6770: 72 65 74 75 72 6e 20 70 56 66 73 2d 3e 78 52 61  return pVfs->xRa
6780: 6e 64 6f 6d 6e 65 73 73 28 70 56 66 73 2c 20 6e  ndomness(pVfs, n
6790: 42 79 74 65 2c 20 7a 42 75 66 4f 75 74 29 3b 0a  Byte, zBufOut);.
67a0: 7d 0a 73 74 61 74 69 63 20 69 6e 74 20 61 73 79  }.static int asy
67b0: 6e 63 53 6c 65 65 70 28 73 71 6c 69 74 65 33 5f  ncSleep(sqlite3_
67c0: 76 66 73 20 2a 70 41 73 79 6e 63 56 66 73 2c 20  vfs *pAsyncVfs, 
67d0: 69 6e 74 20 6e 4d 69 63 72 6f 29 7b 0a 20 20 73  int nMicro){.  s
67e0: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73  qlite3_vfs *pVfs
67f0: 20 3d 20 28 73 71 6c 69 74 65 33 5f 76 66 73 20   = (sqlite3_vfs 
6800: 2a 29 70 41 73 79 6e 63 56 66 73 2d 3e 70 41 70  *)pAsyncVfs->pAp
6810: 70 44 61 74 61 3b 0a 20 20 72 65 74 75 72 6e 20  pData;.  return 
6820: 70 56 66 73 2d 3e 78 53 6c 65 65 70 28 70 56 66  pVfs->xSleep(pVf
6830: 73 2c 20 6e 4d 69 63 72 6f 29 3b 0a 7d 0a 73 74  s, nMicro);.}.st
6840: 61 74 69 63 20 69 6e 74 20 61 73 79 6e 63 43 75  atic int asyncCu
6850: 72 72 65 6e 74 54 69 6d 65 28 73 71 6c 69 74 65  rrentTime(sqlite
6860: 33 5f 76 66 73 20 2a 70 41 73 79 6e 63 56 66 73  3_vfs *pAsyncVfs
6870: 2c 20 64 6f 75 62 6c 65 20 2a 70 54 69 6d 65 4f  , double *pTimeO
6880: 75 74 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76  ut){.  sqlite3_v
6890: 66 73 20 2a 70 56 66 73 20 3d 20 28 73 71 6c 69  fs *pVfs = (sqli
68a0: 74 65 33 5f 76 66 73 20 2a 29 70 41 73 79 6e 63  te3_vfs *)pAsync
68b0: 56 66 73 2d 3e 70 41 70 70 44 61 74 61 3b 0a 20  Vfs->pAppData;. 
68c0: 20 72 65 74 75 72 6e 20 70 56 66 73 2d 3e 78 43   return pVfs->xC
68d0: 75 72 72 65 6e 74 54 69 6d 65 28 70 56 66 73 2c  urrentTime(pVfs,
68e0: 20 70 54 69 6d 65 4f 75 74 29 3b 0a 7d 0a 0a 73   pTimeOut);.}..s
68f0: 74 61 74 69 63 20 73 71 6c 69 74 65 33 5f 76 66  tatic sqlite3_vf
6900: 73 20 61 73 79 6e 63 5f 76 66 73 20 3d 20 7b 0a  s async_vfs = {.
6910: 20 20 31 2c 20 20 20 20 20 20 20 20 20 20 20 20    1,            
6920: 20 20 20 20 20 20 20 20 2f 2a 20 69 56 65 72 73          /* iVers
6930: 69 6f 6e 20 2a 2f 0a 20 20 73 69 7a 65 6f 66 28  ion */.  sizeof(
6940: 41 73 79 6e 63 46 69 6c 65 29 2c 20 20 20 20 2f  AsyncFile),    /
6950: 2a 20 73 7a 4f 73 46 69 6c 65 20 2a 2f 0a 20 20  * szOsFile */.  
6960: 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0,              
6970: 20 20 20 20 20 20 2f 2a 20 6d 78 50 61 74 68 6e        /* mxPathn
6980: 61 6d 65 20 2a 2f 0a 20 20 30 2c 20 20 20 20 20  ame */.  0,     
6990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
69a0: 2a 20 70 4e 65 78 74 20 2a 2f 0a 20 20 22 61 73  * pNext */.  "as
69b0: 79 6e 63 22 2c 20 20 20 20 20 20 20 20 20 20 20  ync",           
69c0: 20 20 20 2f 2a 20 7a 4e 61 6d 65 20 2a 2f 0a 20     /* zName */. 
69d0: 20 30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20   0,             
69e0: 20 20 20 20 20 20 20 2f 2a 20 70 41 70 70 44 61         /* pAppDa
69f0: 74 61 20 2a 2f 0a 20 20 61 73 79 6e 63 4f 70 65  ta */.  asyncOpe
6a00: 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  n,            /*
6a10: 20 78 4f 70 65 6e 20 2a 2f 0a 20 20 61 73 79 6e   xOpen */.  asyn
6a20: 63 44 65 6c 65 74 65 2c 20 20 20 20 20 20 20 20  cDelete,        
6a30: 20 20 2f 2a 20 78 44 65 6c 65 74 65 20 2a 2f 0a    /* xDelete */.
6a40: 20 20 61 73 79 6e 63 41 63 63 65 73 73 2c 20 20    asyncAccess,  
6a50: 20 20 20 20 20 20 20 20 2f 2a 20 78 41 63 63 65          /* xAcce
6a60: 73 73 20 2a 2f 0a 20 20 61 73 79 6e 63 47 65 74  ss */.  asyncGet
6a70: 54 65 6d 70 4e 61 6d 65 2c 20 20 20 20 20 2f 2a  TempName,     /*
6a80: 20 78 47 65 74 54 65 6d 70 4e 61 6d 65 20 2a 2f   xGetTempName */
6a90: 0a 20 20 61 73 79 6e 63 46 75 6c 6c 50 61 74 68  .  asyncFullPath
6aa0: 6e 61 6d 65 2c 20 20 20 20 2f 2a 20 78 46 75 6c  name,    /* xFul
6ab0: 6c 50 61 74 68 6e 61 6d 65 20 2a 2f 0a 20 20 61  lPathname */.  a
6ac0: 73 79 6e 63 44 6c 4f 70 65 6e 2c 20 20 20 20 20  syncDlOpen,     
6ad0: 20 20 20 20 20 2f 2a 20 78 44 6c 4f 70 65 6e 20       /* xDlOpen 
6ae0: 2a 2f 0a 20 20 61 73 79 6e 63 44 6c 45 72 72 6f  */.  asyncDlErro
6af0: 72 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 78 44  r,         /* xD
6b00: 6c 45 72 72 6f 72 20 2a 2f 0a 20 20 61 73 79 6e  lError */.  asyn
6b10: 63 44 6c 53 79 6d 2c 20 20 20 20 20 20 20 20 20  cDlSym,         
6b20: 20 20 2f 2a 20 78 44 6c 53 79 6d 20 2a 2f 0a 20    /* xDlSym */. 
6b30: 20 61 73 79 6e 63 44 6c 43 6c 6f 73 65 2c 20 20   asyncDlClose,  
6b40: 20 20 20 20 20 20 20 2f 2a 20 78 44 6c 43 6c 6f         /* xDlClo
6b50: 73 65 20 2a 2f 0a 20 20 61 73 79 6e 63 52 61 6e  se */.  asyncRan
6b60: 64 6f 6d 6e 65 73 73 2c 20 20 20 20 20 20 2f 2a  domness,      /*
6b70: 20 78 44 6c 45 72 72 6f 72 20 2a 2f 0a 20 20 61   xDlError */.  a
6b80: 73 79 6e 63 53 6c 65 65 70 2c 20 20 20 20 20 20  syncSleep,      
6b90: 20 20 20 20 20 2f 2a 20 78 44 6c 53 79 6d 20 2a       /* xDlSym *
6ba0: 2f 0a 20 20 61 73 79 6e 63 43 75 72 72 65 6e 74  /.  asyncCurrent
6bb0: 54 69 6d 65 20 20 20 20 20 20 2f 2a 20 78 44 6c  Time      /* xDl
6bc0: 43 6c 6f 73 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a  Close */.};../*.
6bd0: 2a 2a 20 43 61 6c 6c 20 74 68 69 73 20 72 6f 75  ** Call this rou
6be0: 74 69 6e 65 20 74 6f 20 65 6e 61 62 6c 65 20 6f  tine to enable o
6bf0: 72 20 64 69 73 61 62 6c 65 20 74 68 65 0a 2a 2a  r disable the.**
6c00: 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 49 4f   asynchronous IO
6c10: 20 66 65 61 74 75 72 65 73 20 69 6d 70 6c 65 6d   features implem
6c20: 65 6e 74 65 64 20 69 6e 20 74 68 69 73 20 66 69  ented in this fi
6c30: 6c 65 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  le. .**.** This 
6c40: 72 6f 75 74 69 6e 65 20 69 73 20 6e 6f 74 20 65  routine is not e
6c50: 76 65 6e 20 72 65 6d 6f 74 65 6c 79 20 74 68 72  ven remotely thr
6c60: 65 61 64 73 61 66 65 2e 20 20 44 6f 20 6e 6f 74  eadsafe.  Do not
6c70: 20 63 61 6c 6c 0a 2a 2a 20 74 68 69 73 20 72 6f   call.** this ro
6c80: 75 74 69 6e 65 20 77 68 69 6c 65 20 61 6e 79 20  utine while any 
6c90: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20  SQLite database 
6ca0: 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 61 72 65 20  connections are 
6cb0: 6f 70 65 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  open..*/.static 
6cc0: 76 6f 69 64 20 61 73 79 6e 63 45 6e 61 62 6c 65  void asyncEnable
6cd0: 28 69 6e 74 20 65 6e 61 62 6c 65 29 7b 0a 20 20  (int enable){.  
6ce0: 69 66 28 20 65 6e 61 62 6c 65 20 29 7b 0a 20 20  if( enable ){.  
6cf0: 20 20 69 66 28 20 21 61 73 79 6e 63 5f 76 66 73    if( !async_vfs
6d00: 2e 70 41 70 70 44 61 74 61 20 29 7b 0a 20 20 20  .pAppData ){.   
6d10: 20 20 20 61 73 79 6e 63 5f 76 66 73 2e 70 41 70     async_vfs.pAp
6d20: 70 44 61 74 61 20 3d 20 28 76 6f 69 64 20 2a 29  pData = (void *)
6d30: 73 71 6c 69 74 65 33 5f 76 66 73 5f 66 69 6e 64  sqlite3_vfs_find
6d40: 28 30 29 3b 0a 20 20 20 20 20 20 61 73 79 6e 63  (0);.      async
6d50: 5f 76 66 73 2e 6d 78 50 61 74 68 6e 61 6d 65 20  _vfs.mxPathname 
6d60: 3d 20 28 28 73 71 6c 69 74 65 33 5f 76 66 73 20  = ((sqlite3_vfs 
6d70: 2a 29 61 73 79 6e 63 5f 76 66 73 2e 70 41 70 70  *)async_vfs.pApp
6d80: 44 61 74 61 29 2d 3e 6d 78 50 61 74 68 6e 61 6d  Data)->mxPathnam
6d90: 65 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  e;.      sqlite3
6da0: 5f 76 66 73 5f 72 65 67 69 73 74 65 72 28 26 61  _vfs_register(&a
6db0: 73 79 6e 63 5f 76 66 73 2c 20 31 29 3b 0a 20 20  sync_vfs, 1);.  
6dc0: 20 20 20 20 73 71 6c 69 74 65 33 48 61 73 68 49      sqlite3HashI
6dd0: 6e 69 74 28 26 61 73 79 6e 63 2e 61 4c 6f 63 6b  nit(&async.aLock
6de0: 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f 42 49  , SQLITE_HASH_BI
6df0: 4e 41 52 59 2c 20 31 29 3b 0a 20 20 20 20 7d 0a  NARY, 1);.    }.
6e00: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66 28    }else{.    if(
6e10: 20 61 73 79 6e 63 5f 76 66 73 2e 70 41 70 70 44   async_vfs.pAppD
6e20: 61 74 61 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  ata ){.      sql
6e30: 69 74 65 33 5f 76 66 73 5f 75 6e 72 65 67 69 73  ite3_vfs_unregis
6e40: 74 65 72 28 26 61 73 79 6e 63 5f 76 66 73 29 3b  ter(&async_vfs);
6e50: 0a 20 20 20 20 20 20 61 73 79 6e 63 5f 76 66 73  .      async_vfs
6e60: 2e 70 41 70 70 44 61 74 61 20 3d 20 30 3b 0a 20  .pAppData = 0;. 
6e70: 20 20 20 20 20 73 71 6c 69 74 65 33 48 61 73 68       sqlite3Hash
6e80: 43 6c 65 61 72 28 26 61 73 79 6e 63 2e 61 4c 6f  Clear(&async.aLo
6e90: 63 6b 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d  ck);.    }.  }.}
6ea0: 0a 0a 2f 2a 20 0a 2a 2a 20 54 68 69 73 20 70 72  ../* .** This pr
6eb0: 6f 63 65 64 75 72 65 20 72 75 6e 73 20 69 6e 20  ocedure runs in 
6ec0: 61 20 73 65 70 61 72 61 74 65 20 74 68 72 65 61  a separate threa
6ed0: 64 2c 20 72 65 61 64 69 6e 67 20 6d 65 73 73 61  d, reading messa
6ee0: 67 65 73 20 6f 66 66 20 6f 66 20 74 68 65 0a 2a  ges off of the.*
6ef0: 2a 20 77 72 69 74 65 20 71 75 65 75 65 20 61 6e  * write queue an
6f00: 64 20 70 72 6f 63 65 73 73 69 6e 67 20 74 68 65  d processing the
6f10: 6d 20 6f 6e 65 20 62 79 20 6f 6e 65 2e 20 20 0a  m one by one.  .
6f20: 2a 2a 0a 2a 2a 20 49 66 20 61 73 79 6e 63 2e 77  **.** If async.w
6f30: 72 69 74 65 72 48 61 6c 74 4e 6f 77 20 69 73 20  riterHaltNow is 
6f40: 74 72 75 65 2c 20 74 68 65 6e 20 74 68 69 73 20  true, then this 
6f50: 70 72 6f 63 65 64 75 72 65 20 65 78 69 74 73 0a  procedure exits.
6f60: 2a 2a 20 61 66 74 65 72 20 70 72 6f 63 65 73 73  ** after process
6f70: 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 6d 65 73  ing a single mes
6f80: 73 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61  sage..**.** If a
6f90: 73 79 6e 63 2e 77 72 69 74 65 72 48 61 6c 74 57  sync.writerHaltW
6fa0: 68 65 6e 49 64 6c 65 20 69 73 20 74 72 75 65 2c  henIdle is true,
6fb0: 20 74 68 65 6e 20 74 68 69 73 20 70 72 6f 63 65   then this proce
6fc0: 64 75 72 65 20 65 78 69 74 73 20 77 68 65 6e 0a  dure exits when.
6fd0: 2a 2a 20 74 68 65 20 77 72 69 74 65 20 71 75 65  ** the write que
6fe0: 75 65 20 69 73 20 65 6d 70 74 79 2e 0a 2a 2a 0a  ue is empty..**.
6ff0: 2a 2a 20 49 66 20 62 6f 74 68 20 6f 66 20 74 68  ** If both of th
7000: 65 20 61 62 6f 76 65 20 76 61 72 69 61 62 6c 65  e above variable
7010: 73 20 61 72 65 20 66 61 6c 73 65 2c 20 74 68 69  s are false, thi
7020: 73 20 70 72 6f 63 65 64 75 72 65 20 72 75 6e 73  s procedure runs
7030: 0a 2a 2a 20 69 6e 64 65 66 69 6e 61 74 65 6c 79  .** indefinately
7040: 2c 20 77 61 69 74 69 6e 67 20 66 6f 72 20 6f 70  , waiting for op
7050: 65 72 61 74 69 6f 6e 73 20 74 6f 20 62 65 20 61  erations to be a
7060: 64 64 65 64 20 74 6f 20 74 68 65 20 77 72 69 74  dded to the writ
7070: 65 20 71 75 65 75 65 0a 2a 2a 20 61 6e 64 20 70  e queue.** and p
7080: 72 6f 63 65 73 73 69 6e 67 20 74 68 65 6d 20 69  rocessing them i
7090: 6e 20 74 68 65 20 6f 72 64 65 72 20 69 6e 20 77  n the order in w
70a0: 68 69 63 68 20 74 68 65 79 20 61 72 72 69 76 65  hich they arrive
70b0: 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 61 72 74 69 66  ..**.** An artif
70c0: 69 63 61 6c 20 64 65 6c 61 79 20 6f 66 20 61 73  ical delay of as
70d0: 79 6e 63 2e 69 6f 44 65 6c 61 79 20 6d 69 6c 6c  ync.ioDelay mill
70e0: 69 73 65 63 6f 6e 64 73 20 69 73 20 69 6e 73 65  iseconds is inse
70f0: 72 74 65 64 20 62 65 66 6f 72 65 0a 2a 2a 20 65  rted before.** e
7100: 61 63 68 20 77 72 69 74 65 20 6f 70 65 72 61 74  ach write operat
7110: 69 6f 6e 20 69 6e 20 6f 72 64 65 72 20 74 6f 20  ion in order to 
7120: 73 69 6d 75 6c 61 74 65 20 74 68 65 20 65 66 66  simulate the eff
7130: 65 63 74 20 6f 66 20 61 20 73 6c 6f 77 20 64 69  ect of a slow di
7140: 73 6b 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 6f  sk..**.** Only o
7150: 6e 65 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74  ne instance of t
7160: 68 69 73 20 70 72 6f 63 65 64 75 72 65 20 6d 61  his procedure ma
7170: 79 20 62 65 20 72 75 6e 6e 69 6e 67 20 61 74 20  y be running at 
7180: 61 20 74 69 6d 65 2e 0a 2a 2f 0a 73 74 61 74 69  a time..*/.stati
7190: 63 20 76 6f 69 64 20 2a 61 73 79 6e 63 57 72 69  c void *asyncWri
71a0: 74 65 72 54 68 72 65 61 64 28 76 6f 69 64 20 2a  terThread(void *
71b0: 4e 6f 74 55 73 65 64 29 7b 0a 20 20 73 71 6c 69  NotUsed){.  sqli
71c0: 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20  te3_vfs *pVfs = 
71d0: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 29 28  (sqlite3_vfs *)(
71e0: 61 73 79 6e 63 5f 76 66 73 2e 70 41 70 70 44 61  async_vfs.pAppDa
71f0: 74 61 29 3b 0a 20 20 41 73 79 6e 63 57 72 69 74  ta);.  AsyncWrit
7200: 65 20 2a 70 20 3d 20 30 3b 0a 20 20 69 6e 74 20  e *p = 0;.  int 
7210: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
7220: 20 20 69 6e 74 20 68 6f 6c 64 69 6e 67 4d 75 74    int holdingMut
7230: 65 78 20 3d 20 30 3b 0a 0a 20 20 69 66 28 20 70  ex = 0;..  if( p
7240: 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 74 72 79  thread_mutex_try
7250: 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 77 72 69 74  lock(&async.writ
7260: 65 72 4d 75 74 65 78 29 20 29 7b 0a 20 20 20 20  erMutex) ){.    
7270: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
7280: 77 68 69 6c 65 28 20 61 73 79 6e 63 2e 77 72 69  while( async.wri
7290: 74 65 72 48 61 6c 74 4e 6f 77 3d 3d 30 20 29 7b  terHaltNow==0 ){
72a0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69 6c  .    sqlite3_fil
72b0: 65 20 2a 70 42 61 73 65 20 3d 20 30 3b 0a 0a 20  e *pBase = 0;.. 
72c0: 20 20 20 69 66 28 20 21 68 6f 6c 64 69 6e 67 4d     if( !holdingM
72d0: 75 74 65 78 20 29 7b 0a 20 20 20 20 20 20 70 74  utex ){.      pt
72e0: 68 72 65 61 64 5f 6d 75 74 65 78 5f 6c 6f 63 6b  hread_mutex_lock
72f0: 28 26 61 73 79 6e 63 2e 71 75 65 75 65 4d 75 74  (&async.queueMut
7300: 65 78 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 77  ex);.    }.    w
7310: 68 69 6c 65 28 20 28 70 20 3d 20 61 73 79 6e 63  hile( (p = async
7320: 2e 70 51 75 65 75 65 46 69 72 73 74 29 3d 3d 30  .pQueueFirst)==0
7330: 20 29 7b 0a 20 20 20 20 20 20 70 74 68 72 65 61   ){.      pthrea
7340: 64 5f 63 6f 6e 64 5f 62 72 6f 61 64 63 61 73 74  d_cond_broadcast
7350: 28 26 61 73 79 6e 63 2e 65 6d 70 74 79 53 69 67  (&async.emptySig
7360: 6e 61 6c 29 3b 0a 20 20 20 20 20 20 69 66 28 20  nal);.      if( 
7370: 61 73 79 6e 63 2e 77 72 69 74 65 72 48 61 6c 74  async.writerHalt
7380: 57 68 65 6e 49 64 6c 65 20 29 7b 0a 20 20 20 20  WhenIdle ){.    
7390: 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65      pthread_mute
73a0: 78 5f 75 6e 6c 6f 63 6b 28 26 61 73 79 6e 63 2e  x_unlock(&async.
73b0: 71 75 65 75 65 4d 75 74 65 78 29 3b 0a 20 20 20  queueMutex);.   
73c0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
73d0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
73e0: 20 41 53 59 4e 43 5f 54 52 41 43 45 28 28 22 49   ASYNC_TRACE(("I
73f0: 44 4c 45 5c 6e 22 29 29 3b 0a 20 20 20 20 20 20  DLE\n"));.      
7400: 20 20 70 74 68 72 65 61 64 5f 63 6f 6e 64 5f 77    pthread_cond_w
7410: 61 69 74 28 26 61 73 79 6e 63 2e 71 75 65 75 65  ait(&async.queue
7420: 53 69 67 6e 61 6c 2c 20 26 61 73 79 6e 63 2e 71  Signal, &async.q
7430: 75 65 75 65 4d 75 74 65 78 29 3b 0a 20 20 20 20  ueueMutex);.    
7440: 20 20 20 20 41 53 59 4e 43 5f 54 52 41 43 45 28      ASYNC_TRACE(
7450: 28 22 57 41 4b 45 55 50 5c 6e 22 29 29 3b 0a 20  ("WAKEUP\n"));. 
7460: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20       }.    }.   
7470: 20 69 66 28 20 70 3d 3d 30 20 29 20 62 72 65 61   if( p==0 ) brea
7480: 6b 3b 0a 20 20 20 20 68 6f 6c 64 69 6e 67 4d 75  k;.    holdingMu
7490: 74 65 78 20 3d 20 31 3b 0a 0a 20 20 20 20 2f 2a  tex = 1;..    /*
74a0: 20 52 69 67 68 74 20 6e 6f 77 20 74 68 69 73 20   Right now this 
74b0: 74 68 72 65 61 64 20 69 73 20 68 6f 6c 64 69 6e  thread is holdin
74c0: 67 20 74 68 65 20 6d 75 74 65 78 20 6f 6e 20 74  g the mutex on t
74d0: 68 65 20 77 72 69 74 65 2d 6f 70 20 71 75 65 75  he write-op queu
74e0: 65 2e 0a 20 20 20 20 2a 2a 20 56 61 72 69 61 62  e..    ** Variab
74f0: 6c 65 20 27 70 27 20 70 6f 69 6e 74 73 20 74 6f  le 'p' points to
7500: 20 74 68 65 20 66 69 72 73 74 20 65 6e 74 72 79   the first entry
7510: 20 69 6e 20 74 68 65 20 77 72 69 74 65 2d 6f 70   in the write-op
7520: 20 71 75 65 75 65 2e 20 49 6e 0a 20 20 20 20 2a   queue. In.    *
7530: 2a 20 74 68 65 20 67 65 6e 65 72 61 6c 20 63 61  * the general ca
7540: 73 65 2c 20 77 65 20 68 6f 6c 64 20 6f 6e 20 74  se, we hold on t
7550: 6f 20 74 68 65 20 6d 75 74 65 78 20 66 6f 72 20  o the mutex for 
7560: 74 68 65 20 65 6e 74 69 72 65 20 62 6f 64 79 20  the entire body 
7570: 6f 66 0a 20 20 20 20 2a 2a 20 74 68 65 20 6c 6f  of.    ** the lo
7580: 6f 70 2e 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20  op. .    **.    
7590: 2a 2a 20 48 6f 77 65 76 65 72 20 69 6e 20 74 68  ** However in th
75a0: 65 20 63 61 73 65 73 20 65 6e 75 6d 65 72 61 74  e cases enumerat
75b0: 65 64 20 62 65 6c 6f 77 2c 20 77 65 20 72 65 6c  ed below, we rel
75c0: 69 6e 71 75 69 73 68 20 74 68 65 20 6d 75 74 65  inquish the mute
75d0: 78 2c 0a 20 20 20 20 2a 2a 20 70 65 72 66 6f 72  x,.    ** perfor
75e0: 6d 20 74 68 65 20 49 4f 2c 20 61 6e 64 20 74 68  m the IO, and th
75f0: 65 6e 20 72 65 2d 72 65 71 75 65 73 74 20 74 68  en re-request th
7600: 65 20 6d 75 74 65 78 20 62 65 66 6f 72 65 20 72  e mutex before r
7610: 65 6d 6f 76 69 6e 67 20 27 70 27 20 66 72 6f 6d  emoving 'p' from
7620: 0a 20 20 20 20 2a 2a 20 74 68 65 20 68 65 61 64  .    ** the head
7630: 20 6f 66 20 74 68 65 20 77 72 69 74 65 2d 6f 70   of the write-op
7640: 20 71 75 65 75 65 2e 20 54 68 65 20 69 64 65 61   queue. The idea
7650: 20 69 73 20 74 6f 20 69 6e 63 72 65 61 73 65 20   is to increase 
7660: 63 6f 6e 63 75 72 72 65 6e 63 79 20 77 69 74 68  concurrency with
7670: 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 20 74  .    ** sqlite t
7680: 68 72 65 61 64 73 2e 0a 20 20 20 20 2a 2a 0a 20  hreads..    **. 
7690: 20 20 20 2a 2a 20 20 20 20 20 2a 20 41 6e 20 41     **     * An A
76a0: 53 59 4e 43 5f 43 4c 4f 53 45 20 6f 70 65 72 61  SYNC_CLOSE opera
76b0: 74 69 6f 6e 2e 0a 20 20 20 20 2a 2a 20 20 20 20  tion..    **    
76c0: 20 2a 20 41 6e 20 41 53 59 4e 43 5f 4f 50 45 4e   * An ASYNC_OPEN
76d0: 45 58 43 4c 55 53 49 56 45 20 6f 70 65 72 61 74  EXCLUSIVE operat
76e0: 69 6f 6e 2e 20 46 6f 72 20 74 68 69 73 20 6f 6e  ion. For this on
76f0: 65 2c 20 77 65 20 72 65 6c 69 6e 71 75 69 73 68  e, we relinquish
7700: 20 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 20 74   .    **       t
7710: 68 65 20 6d 75 74 65 78 2c 20 63 61 6c 6c 20 74  he mutex, call t
7720: 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 78 4f  he underlying xO
7730: 70 65 6e 45 78 63 6c 75 73 69 76 65 28 29 20 66  penExclusive() f
7740: 75 6e 63 74 69 6f 6e 2c 20 74 68 65 6e 0a 20 20  unction, then.  
7750: 20 20 2a 2a 20 20 20 20 20 20 20 72 65 2d 61 71    **       re-aq
7760: 75 69 72 65 20 74 68 65 20 6d 75 74 65 78 20 62  uire the mutex b
7770: 65 66 6f 72 65 20 73 65 74 69 6e 67 20 74 68 65  efore seting the
7780: 20 41 73 79 6e 63 46 69 6c 65 2e 70 42 61 73 65   AsyncFile.pBase
7790: 52 65 61 64 20 0a 20 20 20 20 2a 2a 20 20 20 20  Read .    **    
77a0: 20 20 20 76 61 72 69 61 62 6c 65 2e 0a 20 20 20     variable..   
77b0: 20 2a 2a 20 20 20 20 20 2a 20 41 53 59 4e 43 5f   **     * ASYNC_
77c0: 53 59 4e 43 20 61 6e 64 20 41 53 59 4e 43 5f 57  SYNC and ASYNC_W
77d0: 52 49 54 45 20 6f 70 65 72 61 74 69 6f 6e 73 2c  RITE operations,
77e0: 20 69 66 20 0a 20 20 20 20 2a 2a 20 20 20 20 20   if .    **     
77f0: 20 20 53 51 4c 49 54 45 5f 41 53 59 4e 43 5f 54    SQLITE_ASYNC_T
7800: 57 4f 5f 46 49 4c 45 48 41 4e 44 4c 45 53 20 77  WO_FILEHANDLES w
7810: 61 73 20 73 65 74 20 61 74 20 63 6f 6d 70 69 6c  as set at compil
7820: 65 20 74 69 6d 65 20 61 6e 64 20 74 77 6f 0a 20  e time and two. 
7830: 20 20 20 2a 2a 20 20 20 20 20 20 20 66 69 6c 65     **       file
7840: 2d 68 61 6e 64 6c 65 73 20 61 72 65 20 6f 70 65  -handles are ope
7850: 6e 20 66 6f 72 20 74 68 65 20 70 61 72 74 69 63  n for the partic
7860: 75 6c 61 72 20 66 69 6c 65 20 62 65 69 6e 67 20  ular file being 
7870: 22 73 79 6e 63 65 64 22 2e 0a 20 20 20 20 2a 2f  "synced"..    */
7880: 0a 20 20 20 20 69 66 28 20 61 73 79 6e 63 2e 69  .    if( async.i
7890: 6f 45 72 72 6f 72 21 3d 53 51 4c 49 54 45 5f 4f  oError!=SQLITE_O
78a0: 4b 20 26 26 20 70 2d 3e 6f 70 21 3d 41 53 59 4e  K && p->op!=ASYN
78b0: 43 5f 43 4c 4f 53 45 20 29 7b 0a 20 20 20 20 20  C_CLOSE ){.     
78c0: 20 70 2d 3e 6f 70 20 3d 20 41 53 59 4e 43 5f 4e   p->op = ASYNC_N
78d0: 4f 4f 50 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69  OOP;.    }.    i
78e0: 66 28 20 70 2d 3e 70 46 69 6c 65 44 61 74 61 20  f( p->pFileData 
78f0: 29 7b 0a 20 20 20 20 20 20 70 42 61 73 65 20 3d  ){.      pBase =
7900: 20 70 2d 3e 70 46 69 6c 65 44 61 74 61 2d 3e 70   p->pFileData->p
7910: 42 61 73 65 57 72 69 74 65 3b 0a 20 20 20 20 20  BaseWrite;.     
7920: 20 69 66 28 20 0a 20 20 20 20 20 20 20 20 70 2d   if( .        p-
7930: 3e 6f 70 3d 3d 41 53 59 4e 43 5f 43 4c 4f 53 45  >op==ASYNC_CLOSE
7940: 20 7c 7c 20 0a 20 20 20 20 20 20 20 20 70 2d 3e   || .        p->
7950: 6f 70 3d 3d 41 53 59 4e 43 5f 4f 50 45 4e 45 58  op==ASYNC_OPENEX
7960: 43 4c 55 53 49 56 45 20 7c 7c 0a 20 20 20 20 20  CLUSIVE ||.     
7970: 20 20 20 28 70 42 61 73 65 2d 3e 70 4d 65 74 68     (pBase->pMeth
7980: 6f 64 73 20 26 26 20 28 70 2d 3e 6f 70 3d 3d 41  ods && (p->op==A
7990: 53 59 4e 43 5f 53 59 4e 43 20 7c 7c 20 70 2d 3e  SYNC_SYNC || p->
79a0: 6f 70 3d 3d 41 53 59 4e 43 5f 57 52 49 54 45 29  op==ASYNC_WRITE)
79b0: 20 29 20 0a 20 20 20 20 20 20 29 7b 0a 20 20 20   ) .      ){.   
79c0: 20 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75 74       pthread_mut
79d0: 65 78 5f 75 6e 6c 6f 63 6b 28 26 61 73 79 6e 63  ex_unlock(&async
79e0: 2e 71 75 65 75 65 4d 75 74 65 78 29 3b 0a 20 20  .queueMutex);.  
79f0: 20 20 20 20 20 20 68 6f 6c 64 69 6e 67 4d 75 74        holdingMut
7a00: 65 78 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a  ex = 0;.      }.
7a10: 20 20 20 20 20 20 69 66 28 20 21 70 42 61 73 65        if( !pBase
7a20: 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20  ->pMethods ){.  
7a30: 20 20 20 20 20 20 70 42 61 73 65 20 3d 20 70 2d        pBase = p-
7a40: 3e 70 46 69 6c 65 44 61 74 61 2d 3e 70 42 61 73  >pFileData->pBas
7a50: 65 52 65 61 64 3b 0a 20 20 20 20 20 20 7d 0a 20  eRead;.      }. 
7a60: 20 20 20 7d 0a 0a 20 20 20 20 73 77 69 74 63 68     }..    switch
7a70: 28 20 70 2d 3e 6f 70 20 29 7b 0a 20 20 20 20 20  ( p->op ){.     
7a80: 20 63 61 73 65 20 41 53 59 4e 43 5f 4e 4f 4f 50   case ASYNC_NOOP
7a90: 3a 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  :.        break;
7aa0: 0a 0a 20 20 20 20 20 20 63 61 73 65 20 41 53 59  ..      case ASY
7ab0: 4e 43 5f 57 52 49 54 45 3a 0a 20 20 20 20 20 20  NC_WRITE:.      
7ac0: 20 20 61 73 73 65 72 74 28 20 70 42 61 73 65 20    assert( pBase 
7ad0: 29 3b 0a 20 20 20 20 20 20 20 20 41 53 59 4e 43  );.        ASYNC
7ae0: 5f 54 52 41 43 45 28 28 22 57 52 49 54 45 20 25  _TRACE(("WRITE %
7af0: 73 20 25 64 20 62 79 74 65 73 20 61 74 20 25 64  s %d bytes at %d
7b00: 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20  \n",.           
7b10: 20 20 20 20 20 70 2d 3e 70 46 69 6c 65 44 61 74       p->pFileDat
7b20: 61 2d 3e 7a 4e 61 6d 65 2c 20 70 2d 3e 6e 42 79  a->zName, p->nBy
7b30: 74 65 2c 20 70 2d 3e 69 4f 66 66 73 65 74 29 29  te, p->iOffset))
7b40: 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73  ;.        rc = s
7b50: 71 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 42  qlite3OsWrite(pB
7b60: 61 73 65 2c 20 28 76 6f 69 64 20 2a 29 28 70 2d  ase, (void *)(p-
7b70: 3e 7a 42 75 66 29 2c 20 70 2d 3e 6e 42 79 74 65  >zBuf), p->nByte
7b80: 2c 20 70 2d 3e 69 4f 66 66 73 65 74 29 3b 0a 20  , p->iOffset);. 
7b90: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 0a 20         break;.. 
7ba0: 20 20 20 20 20 63 61 73 65 20 41 53 59 4e 43 5f       case ASYNC_
7bb0: 53 59 4e 43 3a 0a 20 20 20 20 20 20 20 20 61 73  SYNC:.        as
7bc0: 73 65 72 74 28 20 70 42 61 73 65 20 29 3b 0a 20  sert( pBase );. 
7bd0: 20 20 20 20 20 20 20 41 53 59 4e 43 5f 54 52 41         ASYNC_TRA
7be0: 43 45 28 28 22 53 59 4e 43 20 25 73 5c 6e 22 2c  CE(("SYNC %s\n",
7bf0: 20 70 2d 3e 70 46 69 6c 65 44 61 74 61 2d 3e 7a   p->pFileData->z
7c00: 4e 61 6d 65 29 29 3b 0a 20 20 20 20 20 20 20 20  Name));.        
7c10: 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79  rc = sqlite3OsSy
7c20: 6e 63 28 70 42 61 73 65 2c 20 70 2d 3e 6e 42 79  nc(pBase, p->nBy
7c30: 74 65 29 3b 0a 20 20 20 20 20 20 20 20 62 72 65  te);.        bre
7c40: 61 6b 3b 0a 0a 20 20 20 20 20 20 63 61 73 65 20  ak;..      case 
7c50: 41 53 59 4e 43 5f 54 52 55 4e 43 41 54 45 3a 0a  ASYNC_TRUNCATE:.
7c60: 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20          assert( 
7c70: 70 42 61 73 65 20 29 3b 0a 20 20 20 20 20 20 20  pBase );.       
7c80: 20 41 53 59 4e 43 5f 54 52 41 43 45 28 28 22 54   ASYNC_TRACE(("T
7c90: 52 55 4e 43 41 54 45 20 25 73 20 74 6f 20 25 64  RUNCATE %s to %d
7ca0: 20 62 79 74 65 73 5c 6e 22 2c 20 0a 20 20 20 20   bytes\n", .    
7cb0: 20 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70              p->p
7cc0: 46 69 6c 65 44 61 74 61 2d 3e 7a 4e 61 6d 65 2c  FileData->zName,
7cd0: 20 70 2d 3e 69 4f 66 66 73 65 74 29 29 3b 0a 20   p->iOffset));. 
7ce0: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69         rc = sqli
7cf0: 74 65 33 4f 73 54 72 75 6e 63 61 74 65 28 70 42  te3OsTruncate(pB
7d00: 61 73 65 2c 20 70 2d 3e 69 4f 66 66 73 65 74 29  ase, p->iOffset)
7d10: 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  ;.        break;
7d20: 0a 0a 20 20 20 20 20 20 63 61 73 65 20 41 53 59  ..      case ASY
7d30: 4e 43 5f 43 4c 4f 53 45 3a 0a 20 20 20 20 20 20  NC_CLOSE:.      
7d40: 20 20 41 53 59 4e 43 5f 54 52 41 43 45 28 28 22    ASYNC_TRACE(("
7d50: 43 4c 4f 53 45 20 25 73 5c 6e 22 2c 20 70 2d 3e  CLOSE %s\n", p->
7d60: 70 46 69 6c 65 44 61 74 61 2d 3e 7a 4e 61 6d 65  pFileData->zName
7d70: 29 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  ));.        sqli
7d80: 74 65 33 4f 73 43 6c 6f 73 65 28 70 2d 3e 70 46  te3OsClose(p->pF
7d90: 69 6c 65 44 61 74 61 2d 3e 70 42 61 73 65 57 72  ileData->pBaseWr
7da0: 69 74 65 29 3b 0a 20 20 20 20 20 20 20 20 73 71  ite);.        sq
7db0: 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 2d 3e  lite3OsClose(p->
7dc0: 70 46 69 6c 65 44 61 74 61 2d 3e 70 42 61 73 65  pFileData->pBase
7dd0: 52 65 61 64 29 3b 0a 20 20 20 20 20 20 20 20 73  Read);.        s
7de0: 71 6c 69 74 65 33 5f 66 72 65 65 28 70 2d 3e 70  qlite3_free(p->p
7df0: 46 69 6c 65 44 61 74 61 29 3b 0a 20 20 20 20 20  FileData);.     
7e00: 20 20 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 20     break;..     
7e10: 20 63 61 73 65 20 41 53 59 4e 43 5f 44 45 4c 45   case ASYNC_DELE
7e20: 54 45 3a 0a 20 20 20 20 20 20 20 20 41 53 59 4e  TE:.        ASYN
7e30: 43 5f 54 52 41 43 45 28 28 22 44 45 4c 45 54 45  C_TRACE(("DELETE
7e40: 20 25 73 5c 6e 22 2c 20 70 2d 3e 7a 42 75 66 29   %s\n", p->zBuf)
7e50: 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20  );.        rc = 
7e60: 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 28  sqlite3OsDelete(
7e70: 70 56 66 73 2c 20 70 2d 3e 7a 42 75 66 2c 20 28  pVfs, p->zBuf, (
7e80: 69 6e 74 29 70 2d 3e 69 4f 66 66 73 65 74 29 3b  int)p->iOffset);
7e90: 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  .        break;.
7ea0: 0a 20 20 20 20 20 20 63 61 73 65 20 41 53 59 4e  .      case ASYN
7eb0: 43 5f 4f 50 45 4e 45 58 43 4c 55 53 49 56 45 3a  C_OPENEXCLUSIVE:
7ec0: 20 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 66   {.        int f
7ed0: 6c 61 67 73 20 3d 20 28 69 6e 74 29 70 2d 3e 69  lags = (int)p->i
7ee0: 4f 66 66 73 65 74 3b 0a 20 20 20 20 20 20 20 20  Offset;.        
7ef0: 41 73 79 6e 63 46 69 6c 65 44 61 74 61 20 2a 70  AsyncFileData *p
7f00: 44 61 74 61 20 3d 20 70 2d 3e 70 46 69 6c 65 44  Data = p->pFileD
7f10: 61 74 61 3b 0a 20 20 20 20 20 20 20 20 41 53 59  ata;.        ASY
7f20: 4e 43 5f 54 52 41 43 45 28 28 22 4f 50 45 4e 20  NC_TRACE(("OPEN 
7f30: 25 73 20 66 6c 61 67 73 3d 25 64 5c 6e 22 2c 20  %s flags=%d\n", 
7f40: 70 2d 3e 7a 42 75 66 2c 20 28 69 6e 74 29 70 2d  p->zBuf, (int)p-
7f50: 3e 69 4f 66 66 73 65 74 29 29 3b 0a 20 20 20 20  >iOffset));.    
7f60: 20 20 20 20 61 73 73 65 72 74 28 70 44 61 74 61      assert(pData
7f70: 2d 3e 70 42 61 73 65 52 65 61 64 2d 3e 70 4d 65  ->pBaseRead->pMe
7f80: 74 68 6f 64 73 3d 3d 30 20 26 26 20 70 44 61 74  thods==0 && pDat
7f90: 61 2d 3e 70 42 61 73 65 57 72 69 74 65 2d 3e 70  a->pBaseWrite->p
7fa0: 4d 65 74 68 6f 64 73 3d 3d 30 29 3b 0a 20 20 20  Methods==0);.   
7fb0: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65       rc = sqlite
7fc0: 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20 70 44  3OsOpen(pVfs, pD
7fd0: 61 74 61 2d 3e 7a 4e 61 6d 65 2c 20 70 44 61 74  ata->zName, pDat
7fe0: 61 2d 3e 70 42 61 73 65 52 65 61 64 2c 20 66 6c  a->pBaseRead, fl
7ff0: 61 67 73 2c 20 30 29 3b 0a 20 20 20 20 20 20 20  ags, 0);.       
8000: 20 61 73 73 65 72 74 28 20 68 6f 6c 64 69 6e 67   assert( holding
8010: 4d 75 74 65 78 3d 3d 30 20 29 3b 0a 20 20 20 20  Mutex==0 );.    
8020: 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65      pthread_mute
8030: 78 5f 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 71 75  x_lock(&async.qu
8040: 65 75 65 4d 75 74 65 78 29 3b 0a 20 20 20 20 20  eueMutex);.     
8050: 20 20 20 68 6f 6c 64 69 6e 67 4d 75 74 65 78 20     holdingMutex 
8060: 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 62 72 65  = 1;.        bre
8070: 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20  ak;.      }..   
8080: 20 20 20 64 65 66 61 75 6c 74 3a 20 61 73 73 65     default: asse
8090: 72 74 28 21 22 49 6c 6c 65 67 61 6c 20 76 61 6c  rt(!"Illegal val
80a0: 75 65 20 66 6f 72 20 41 73 79 6e 63 57 72 69 74  ue for AsyncWrit
80b0: 65 2e 6f 70 22 29 3b 0a 20 20 20 20 7d 0a 0a 20  e.op");.    }.. 
80c0: 20 20 20 2f 2a 20 49 66 20 77 65 20 64 69 64 6e     /* If we didn
80d0: 27 74 20 68 61 6e 67 20 6f 6e 20 74 6f 20 74 68  't hang on to th
80e0: 65 20 6d 75 74 65 78 20 64 75 72 69 6e 67 20 74  e mutex during t
80f0: 68 65 20 49 4f 20 6f 70 2c 20 6f 62 74 61 69 6e  he IO op, obtain
8100: 20 69 74 20 6e 6f 77 0a 20 20 20 20 2a 2a 20 73   it now.    ** s
8110: 6f 20 74 68 61 74 20 74 68 65 20 41 73 79 6e 63  o that the Async
8120: 57 72 69 74 65 20 73 74 72 75 63 74 75 72 65 20  Write structure 
8130: 63 61 6e 20 62 65 20 73 61 66 65 6c 79 20 72 65  can be safely re
8140: 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 0a  moved from the .
8150: 20 20 20 20 2a 2a 20 67 6c 6f 62 61 6c 20 77 72      ** global wr
8160: 69 74 65 2d 6f 70 20 71 75 65 75 65 2e 0a 20 20  ite-op queue..  
8170: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 21 68 6f    */.    if( !ho
8180: 6c 64 69 6e 67 4d 75 74 65 78 20 29 7b 0a 20 20  ldingMutex ){.  
8190: 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65      pthread_mute
81a0: 78 5f 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 71 75  x_lock(&async.qu
81b0: 65 75 65 4d 75 74 65 78 29 3b 0a 20 20 20 20 20  eueMutex);.     
81c0: 20 68 6f 6c 64 69 6e 67 4d 75 74 65 78 20 3d 20   holdingMutex = 
81d0: 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2f 2a 20  1;.    }.    /* 
81e0: 41 53 59 4e 43 5f 54 52 41 43 45 28 28 22 55 4e  ASYNC_TRACE(("UN
81f0: 4c 49 4e 4b 20 25 70 5c 6e 22 2c 20 70 29 29 3b  LINK %p\n", p));
8200: 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 3d 3d 61   */.    if( p==a
8210: 73 79 6e 63 2e 70 51 75 65 75 65 4c 61 73 74 20  sync.pQueueLast 
8220: 29 7b 0a 20 20 20 20 20 20 61 73 79 6e 63 2e 70  ){.      async.p
8230: 51 75 65 75 65 4c 61 73 74 20 3d 20 30 3b 0a 20  QueueLast = 0;. 
8240: 20 20 20 7d 0a 20 20 20 20 61 73 79 6e 63 2e 70     }.    async.p
8250: 51 75 65 75 65 46 69 72 73 74 20 3d 20 70 2d 3e  QueueFirst = p->
8260: 70 4e 65 78 74 3b 0a 20 20 20 20 73 71 6c 69 74  pNext;.    sqlit
8270: 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20  e3_free(p);.    
8280: 61 73 73 65 72 74 28 20 68 6f 6c 64 69 6e 67 4d  assert( holdingM
8290: 75 74 65 78 20 29 3b 0a 0a 20 20 20 20 2f 2a 20  utex );..    /* 
82a0: 41 6e 20 49 4f 20 65 72 72 6f 72 20 68 61 73 20  An IO error has 
82b0: 6f 63 63 75 72 65 64 2e 20 57 65 20 63 61 6e 6e  occured. We cann
82c0: 6f 74 20 72 65 70 6f 72 74 20 74 68 65 20 65 72  ot report the er
82d0: 72 6f 72 20 62 61 63 6b 20 74 6f 20 74 68 65 0a  ror back to the.
82e0: 20 20 20 20 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f      ** connectio
82f0: 6e 20 74 68 61 74 20 72 65 71 75 65 73 74 65 64  n that requested
8300: 20 74 68 65 20 49 2f 4f 20 73 69 6e 63 65 20 74   the I/O since t
8310: 68 65 20 65 72 72 6f 72 20 68 61 70 70 65 6e 65  he error happene
8320: 64 20 0a 20 20 20 20 2a 2a 20 61 73 79 6e 63 68  d .    ** asynch
8330: 72 6f 6e 6f 75 73 6c 79 2e 20 20 54 68 65 20 63  ronously.  The c
8340: 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 73 20 61 6c  onnection has al
8350: 72 65 61 64 79 20 6d 6f 76 65 64 20 6f 6e 2e 20  ready moved on. 
8360: 20 54 68 65 72 65 20 0a 20 20 20 20 2a 2a 20 72   There .    ** r
8370: 65 61 6c 6c 79 20 69 73 20 6e 6f 62 6f 64 79 20  eally is nobody 
8380: 74 6f 20 72 65 70 6f 72 74 20 74 68 65 20 65 72  to report the er
8390: 72 6f 72 20 74 6f 2e 0a 20 20 20 20 2a 2a 0a 20  ror to..    **. 
83a0: 20 20 20 2a 2a 20 54 68 65 20 66 69 6c 65 20 66     ** The file f
83b0: 6f 72 20 77 68 69 63 68 20 74 68 65 20 65 72 72  or which the err
83c0: 6f 72 20 6f 63 63 75 72 65 64 20 6d 61 79 20 68  or occured may h
83d0: 61 76 65 20 62 65 65 6e 20 61 20 64 61 74 61 62  ave been a datab
83e0: 61 73 65 20 6f 72 0a 20 20 20 20 2a 2a 20 6a 6f  ase or.    ** jo
83f0: 75 72 6e 61 6c 20 66 69 6c 65 2e 20 52 65 67 61  urnal file. Rega
8400: 72 64 6c 65 73 73 2c 20 6e 6f 6e 65 20 6f 66 20  rdless, none of 
8410: 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 71 75  the currently qu
8420: 65 75 65 64 20 6f 70 65 72 61 74 69 6f 6e 73 0a  eued operations.
8430: 20 20 20 20 2a 2a 20 61 73 73 6f 63 69 61 74 65      ** associate
8440: 64 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20  d with the same 
8450: 64 61 74 61 62 61 73 65 20 73 68 6f 75 6c 64 20  database should 
8460: 6e 6f 77 20 62 65 20 70 65 72 66 6f 72 6d 65 64  now be performed
8470: 2e 20 4e 6f 72 20 73 68 6f 75 6c 64 0a 20 20 20  . Nor should.   
8480: 20 2a 2a 20 61 6e 79 20 73 75 62 73 65 71 75 65   ** any subseque
8490: 6e 74 6c 79 20 72 65 71 75 65 73 74 65 64 20 49  ntly requested I
84a0: 4f 20 6f 6e 20 65 69 74 68 65 72 20 61 20 64 61  O on either a da
84b0: 74 61 62 61 73 65 20 6f 72 20 6a 6f 75 72 6e 61  tabase or journa
84c0: 6c 20 66 69 6c 65 20 0a 20 20 20 20 2a 2a 20 68  l file .    ** h
84d0: 61 6e 64 6c 65 20 66 6f 72 20 74 68 65 20 73 61  andle for the sa
84e0: 6d 65 20 64 61 74 61 62 61 73 65 20 62 65 20 61  me database be a
84f0: 63 63 65 70 74 65 64 20 75 6e 74 69 6c 20 74 68  ccepted until th
8500: 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 0a  e main database.
8510: 20 20 20 20 2a 2a 20 66 69 6c 65 20 68 61 6e 64      ** file hand
8520: 6c 65 20 68 61 73 20 62 65 65 6e 20 63 6c 6f 73  le has been clos
8530: 65 64 20 61 6e 64 20 72 65 6f 70 65 6e 65 64 2e  ed and reopened.
8540: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 46  .    **.    ** F
8550: 75 72 74 68 65 72 6d 6f 72 65 2c 20 6e 6f 20 66  urthermore, no f
8560: 75 72 74 68 65 72 20 49 4f 20 73 68 6f 75 6c 64  urther IO should
8570: 20 62 65 20 71 75 65 75 65 64 20 6f 72 20 70 65   be queued or pe
8580: 72 66 6f 72 6d 65 64 20 6f 6e 20 61 6e 79 20 66  rformed on any f
8590: 69 6c 65 0a 20 20 20 20 2a 2a 20 68 61 6e 64 6c  ile.    ** handl
85a0: 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74  e associated wit
85b0: 68 20 61 20 64 61 74 61 62 61 73 65 20 74 68 61  h a database tha
85c0: 74 20 6d 61 79 20 68 61 76 65 20 62 65 65 6e 20  t may have been 
85d0: 70 61 72 74 20 6f 66 20 61 20 0a 20 20 20 20 2a  part of a .    *
85e0: 2a 20 6d 75 6c 74 69 2d 66 69 6c 65 20 74 72 61  * multi-file tra
85f0: 6e 73 61 63 74 69 6f 6e 20 74 68 61 74 20 69 6e  nsaction that in
8600: 63 6c 75 64 65 64 20 74 68 65 20 64 61 74 61 62  cluded the datab
8610: 61 73 65 20 61 73 73 6f 63 69 61 74 65 64 20 77  ase associated w
8620: 69 74 68 20 0a 20 20 20 20 2a 2a 20 74 68 65 20  ith .    ** the 
8630: 49 4f 20 65 72 72 6f 72 20 28 69 2e 65 2e 20 61  IO error (i.e. a
8640: 20 64 61 74 61 62 61 73 65 20 41 54 54 41 43 48   database ATTACH
8650: 65 64 20 74 6f 20 74 68 65 20 73 61 6d 65 20 68  ed to the same h
8660: 61 6e 64 6c 65 20 61 74 20 73 6f 6d 65 20 0a 20  andle at some . 
8670: 20 20 20 2a 2a 20 70 6f 69 6e 74 20 69 6e 20 74     ** point in t
8680: 69 6d 65 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  ime)..    */.   
8690: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
86a0: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 61 73 79 6e  OK ){.      asyn
86b0: 63 2e 69 6f 45 72 72 6f 72 20 3d 20 72 63 3b 0a  c.ioError = rc;.
86c0: 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 72      }..    /* Dr
86d0: 6f 70 20 74 68 65 20 71 75 65 75 65 20 6d 75 74  op the queue mut
86e0: 65 78 20 62 65 66 6f 72 65 20 63 6f 6e 74 69 6e  ex before contin
86f0: 75 69 6e 67 20 74 6f 20 74 68 65 20 6e 65 78 74  uing to the next
8700: 20 77 72 69 74 65 20 6f 70 65 72 61 74 69 6f 6e   write operation
8710: 0a 20 20 20 20 2a 2a 20 69 6e 20 6f 72 64 65 72  .    ** in order
8720: 20 74 6f 20 67 69 76 65 20 6f 74 68 65 72 20 74   to give other t
8730: 68 72 65 61 64 73 20 61 20 63 68 61 6e 63 65 20  hreads a chance 
8740: 74 6f 20 77 6f 72 6b 20 77 69 74 68 20 74 68 65  to work with the
8750: 20 77 72 69 74 65 20 71 75 65 75 65 2e 0a 20 20   write queue..  
8760: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 21 61 73    */.    if( !as
8770: 79 6e 63 2e 70 51 75 65 75 65 46 69 72 73 74 20  ync.pQueueFirst 
8780: 7c 7c 20 21 61 73 79 6e 63 2e 69 6f 45 72 72 6f  || !async.ioErro
8790: 72 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  r ){.      sqlit
87a0: 65 33 41 70 69 45 78 69 74 28 30 2c 20 30 29 3b  e3ApiExit(0, 0);
87b0: 0a 20 20 20 20 20 20 70 74 68 72 65 61 64 5f 6d  .      pthread_m
87c0: 75 74 65 78 5f 75 6e 6c 6f 63 6b 28 26 61 73 79  utex_unlock(&asy
87d0: 6e 63 2e 71 75 65 75 65 4d 75 74 65 78 29 3b 0a  nc.queueMutex);.
87e0: 20 20 20 20 20 20 68 6f 6c 64 69 6e 67 4d 75 74        holdingMut
87f0: 65 78 20 3d 20 30 3b 0a 20 20 20 20 20 20 69 66  ex = 0;.      if
8800: 28 20 61 73 79 6e 63 2e 69 6f 44 65 6c 61 79 3e  ( async.ioDelay>
8810: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  0 ){.        sql
8820: 69 74 65 33 4f 73 53 6c 65 65 70 28 70 56 66 73  ite3OsSleep(pVfs
8830: 2c 20 61 73 79 6e 63 2e 69 6f 44 65 6c 61 79 29  , async.ioDelay)
8840: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ;.      }else{. 
8850: 20 20 20 20 20 20 20 73 63 68 65 64 5f 79 69 65         sched_yie
8860: 6c 64 28 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  ld();.      }.  
8870: 20 20 7d 0a 20 20 7d 0a 20 20 0a 20 20 70 74 68    }.  }.  .  pth
8880: 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f 63  read_mutex_unloc
8890: 6b 28 26 61 73 79 6e 63 2e 77 72 69 74 65 72 4d  k(&async.writerM
88a0: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20  utex);.  return 
88b0: 30 3b 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a  0;.}../*********
88c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
88d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
88e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
88f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8900: 2a 0a 2a 2a 20 54 68 65 20 72 65 6d 61 69 6e 69  *.** The remaini
8910: 6e 67 20 63 6f 64 65 20 64 65 66 69 6e 65 73 20  ng code defines 
8920: 61 20 54 63 6c 20 69 6e 74 65 72 66 61 63 65 20  a Tcl interface 
8930: 66 6f 72 20 74 65 73 74 69 6e 67 20 74 68 65 20  for testing the 
8940: 61 73 79 6e 63 68 72 6f 6e 6f 75 73 0a 2a 2a 20  asynchronous.** 
8950: 49 4f 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  IO implementatio
8960: 6e 20 69 6e 20 74 68 69 73 20 66 69 6c 65 2e 0a  n in this file..
8970: 2a 2a 0a 2a 2a 20 54 6f 20 61 64 61 70 74 20 74  **.** To adapt t
8980: 68 65 20 63 6f 64 65 20 74 6f 20 61 20 6e 6f 6e  he code to a non
8990: 2d 54 43 4c 20 65 6e 76 69 72 6f 6e 6d 65 6e 74  -TCL environment
89a0: 2c 20 64 65 6c 65 74 65 20 6f 72 20 63 6f 6d 6d  , delete or comm
89b0: 65 6e 74 20 6f 75 74 0a 2a 2a 20 74 68 65 20 63  ent out.** the c
89c0: 6f 64 65 20 74 68 61 74 20 66 6f 6c 6c 6f 77 73  ode that follows
89d0: 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 73 71 6c 69  ..*/../*.** sqli
89e0: 74 65 33 61 73 79 6e 63 5f 65 6e 61 62 6c 65 20  te3async_enable 
89f0: 3f 59 45 53 2f 4e 4f 3f 0a 2a 2a 0a 2a 2a 20 45  ?YES/NO?.**.** E
8a00: 6e 61 62 6c 65 20 6f 72 20 64 69 73 61 62 6c 65  nable or disable
8a10: 20 74 68 65 20 61 73 79 6e 63 68 72 6f 6e 6f 75   the asynchronou
8a20: 73 20 49 2f 4f 20 62 61 63 6b 65 6e 64 2e 20 20  s I/O backend.  
8a30: 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 69 73 0a  This command is.
8a40: 2a 2a 20 6e 6f 74 20 74 68 72 65 61 64 2d 73 61  ** not thread-sa
8a50: 66 65 2e 20 20 44 6f 20 6e 6f 74 20 63 61 6c 6c  fe.  Do not call
8a60: 20 69 74 20 77 68 69 6c 65 20 61 6e 79 20 64 61   it while any da
8a70: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f  tabase connectio
8a80: 6e 73 0a 2a 2a 20 61 72 65 20 6f 70 65 6e 2e 0a  ns.** are open..
8a90: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 74 65  */.static int te
8aa0: 73 74 41 73 79 6e 63 45 6e 61 62 6c 65 28 0a 20  stAsyncEnable(. 
8ab0: 20 76 6f 69 64 20 2a 20 63 6c 69 65 6e 74 44 61   void * clientDa
8ac0: 74 61 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70  ta,.  Tcl_Interp
8ad0: 20 2a 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20   *interp,.  int 
8ae0: 6f 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20  objc,.  Tcl_Obj 
8af0: 2a 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b  *CONST objv[].){
8b00: 0a 20 20 69 66 28 20 6f 62 6a 63 21 3d 31 20 26  .  if( objc!=1 &
8b10: 26 20 6f 62 6a 63 21 3d 32 20 29 7b 0a 20 20 20  & objc!=2 ){.   
8b20: 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67   Tcl_WrongNumArg
8b30: 73 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a  s(interp, 1, obj
8b40: 76 2c 20 22 3f 59 45 53 2f 4e 4f 3f 22 29 3b 0a  v, "?YES/NO?");.
8b50: 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45      return TCL_E
8b60: 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20  RROR;.  }.  if( 
8b70: 6f 62 6a 63 3d 3d 31 20 29 7b 0a 20 20 20 20 54  objc==1 ){.    T
8b80: 63 6c 5f 53 65 74 4f 62 6a 52 65 73 75 6c 74 28  cl_SetObjResult(
8b90: 69 6e 74 65 72 70 2c 20 54 63 6c 5f 4e 65 77 42  interp, Tcl_NewB
8ba0: 6f 6f 6c 65 61 6e 4f 62 6a 28 61 73 79 6e 63 5f  ooleanObj(async_
8bb0: 76 66 73 2e 70 41 70 70 44 61 74 61 21 3d 30 29  vfs.pAppData!=0)
8bc0: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  );.  }else{.    
8bd0: 69 6e 74 20 65 6e 3b 0a 20 20 20 20 69 66 28 20  int en;.    if( 
8be0: 54 63 6c 5f 47 65 74 42 6f 6f 6c 65 61 6e 46 72  Tcl_GetBooleanFr
8bf0: 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62  omObj(interp, ob
8c00: 6a 76 5b 31 5d 2c 20 26 65 6e 29 20 29 20 72 65  jv[1], &en) ) re
8c10: 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a  turn TCL_ERROR;.
8c20: 20 20 20 20 61 73 79 6e 63 45 6e 61 62 6c 65 28      asyncEnable(
8c30: 65 6e 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  en);.  }.  retur
8c40: 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  n TCL_OK;.}../*.
8c50: 2a 2a 20 73 71 6c 69 74 65 33 61 73 79 6e 63 5f  ** sqlite3async_
8c60: 68 61 6c 74 20 20 22 6e 6f 77 22 7c 22 69 64 6c  halt  "now"|"idl
8c70: 65 22 7c 22 6e 65 76 65 72 22 0a 2a 2a 0a 2a 2a  e"|"never".**.**
8c80: 20 53 65 74 20 74 68 65 20 63 6f 6e 64 69 74 69   Set the conditi
8c90: 6f 6e 73 20 61 74 20 77 68 69 63 68 20 74 68 65  ons at which the
8ca0: 20 77 72 69 74 65 72 20 74 68 72 65 61 64 20 77   writer thread w
8cb0: 69 6c 6c 20 68 61 6c 74 2e 0a 2a 2f 0a 73 74 61  ill halt..*/.sta
8cc0: 74 69 63 20 69 6e 74 20 74 65 73 74 41 73 79 6e  tic int testAsyn
8cd0: 63 48 61 6c 74 28 0a 20 20 76 6f 69 64 20 2a 20  cHalt(.  void * 
8ce0: 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20 54 63  clientData,.  Tc
8cf0: 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70  l_Interp *interp
8d00: 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20  ,.  int objc,.  
8d10: 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f  Tcl_Obj *CONST o
8d20: 62 6a 76 5b 5d 0a 29 7b 0a 20 20 63 6f 6e 73 74  bjv[].){.  const
8d30: 20 63 68 61 72 20 2a 7a 43 6f 6e 64 3b 0a 20 20   char *zCond;.  
8d40: 69 66 28 20 6f 62 6a 63 21 3d 32 20 29 7b 0a 20  if( objc!=2 ){. 
8d50: 20 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41     Tcl_WrongNumA
8d60: 72 67 73 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f  rgs(interp, 1, o
8d70: 62 6a 76 2c 20 22 5c 22 6e 6f 77 5c 22 7c 5c 22  bjv, "\"now\"|\"
8d80: 69 64 6c 65 5c 22 7c 5c 22 6e 65 76 65 72 5c 22  idle\"|\"never\"
8d90: 22 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 54  ");.    return T
8da0: 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20  CL_ERROR;.  }.  
8db0: 7a 43 6f 6e 64 20 3d 20 54 63 6c 5f 47 65 74 53  zCond = Tcl_GetS
8dc0: 74 72 69 6e 67 28 6f 62 6a 76 5b 31 5d 29 3b 0a  tring(objv[1]);.
8dd0: 20 20 69 66 28 20 73 74 72 63 6d 70 28 7a 43 6f    if( strcmp(zCo
8de0: 6e 64 2c 20 22 6e 6f 77 22 29 3d 3d 30 20 29 7b  nd, "now")==0 ){
8df0: 0a 20 20 20 20 61 73 79 6e 63 2e 77 72 69 74 65  .    async.write
8e00: 72 48 61 6c 74 4e 6f 77 20 3d 20 31 3b 0a 20 20  rHaltNow = 1;.  
8e10: 20 20 70 74 68 72 65 61 64 5f 63 6f 6e 64 5f 62    pthread_cond_b
8e20: 72 6f 61 64 63 61 73 74 28 26 61 73 79 6e 63 2e  roadcast(&async.
8e30: 71 75 65 75 65 53 69 67 6e 61 6c 29 3b 0a 20 20  queueSignal);.  
8e40: 7d 65 6c 73 65 20 69 66 28 20 73 74 72 63 6d 70  }else if( strcmp
8e50: 28 7a 43 6f 6e 64 2c 20 22 69 64 6c 65 22 29 3d  (zCond, "idle")=
8e60: 3d 30 20 29 7b 0a 20 20 20 20 61 73 79 6e 63 2e  =0 ){.    async.
8e70: 77 72 69 74 65 72 48 61 6c 74 57 68 65 6e 49 64  writerHaltWhenId
8e80: 6c 65 20 3d 20 31 3b 0a 20 20 20 20 61 73 79 6e  le = 1;.    asyn
8e90: 63 2e 77 72 69 74 65 72 48 61 6c 74 4e 6f 77 20  c.writerHaltNow 
8ea0: 3d 20 30 3b 0a 20 20 20 20 70 74 68 72 65 61 64  = 0;.    pthread
8eb0: 5f 63 6f 6e 64 5f 62 72 6f 61 64 63 61 73 74 28  _cond_broadcast(
8ec0: 26 61 73 79 6e 63 2e 71 75 65 75 65 53 69 67 6e  &async.queueSign
8ed0: 61 6c 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28  al);.  }else if(
8ee0: 20 73 74 72 63 6d 70 28 7a 43 6f 6e 64 2c 20 22   strcmp(zCond, "
8ef0: 6e 65 76 65 72 22 29 3d 3d 30 20 29 7b 0a 20 20  never")==0 ){.  
8f00: 20 20 61 73 79 6e 63 2e 77 72 69 74 65 72 48 61    async.writerHa
8f10: 6c 74 57 68 65 6e 49 64 6c 65 20 3d 20 30 3b 0a  ltWhenIdle = 0;.
8f20: 20 20 20 20 61 73 79 6e 63 2e 77 72 69 74 65 72      async.writer
8f30: 48 61 6c 74 4e 6f 77 20 3d 20 30 3b 0a 20 20 7d  HaltNow = 0;.  }
8f40: 65 6c 73 65 7b 0a 20 20 20 20 54 63 6c 5f 41 70  else{.    Tcl_Ap
8f50: 70 65 6e 64 52 65 73 75 6c 74 28 69 6e 74 65 72  pendResult(inter
8f60: 70 2c 20 0a 20 20 20 20 20 20 22 73 68 6f 75 6c  p, .      "shoul
8f70: 64 20 62 65 20 6f 6e 65 20 6f 66 3a 20 5c 22 6e  d be one of: \"n
8f80: 6f 77 5c 22 2c 20 5c 22 69 64 6c 65 5c 22 2c 20  ow\", \"idle\", 
8f90: 6f 72 20 5c 22 6e 65 76 65 72 5c 22 22 2c 20 28  or \"never\"", (
8fa0: 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 65  char*)0);.    re
8fb0: 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a  turn TCL_ERROR;.
8fc0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 54 43 4c    }.  return TCL
8fd0: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 73 71  _OK;.}../*.** sq
8fe0: 6c 69 74 65 33 61 73 79 6e 63 5f 64 65 6c 61 79  lite3async_delay
8ff0: 20 3f 4d 53 3f 0a 2a 2a 0a 2a 2a 20 51 75 65 72   ?MS?.**.** Quer
9000: 79 20 6f 72 20 73 65 74 20 74 68 65 20 6e 75 6d  y or set the num
9010: 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f  ber of milliseco
9020: 6e 64 73 20 6f 66 20 64 65 6c 61 79 20 69 6e 20  nds of delay in 
9030: 74 68 65 20 77 72 69 74 65 72 0a 2a 2a 20 74 68  the writer.** th
9040: 72 65 61 64 20 61 66 74 65 72 20 65 61 63 68 20  read after each 
9050: 77 72 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 2e  write operation.
9060: 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73    The default is
9070: 20 30 2e 20 20 42 79 20 69 6e 63 72 65 61 73 69   0.  By increasi
9080: 6e 67 0a 2a 2a 20 74 68 65 20 6d 65 6d 6f 72 79  ng.** the memory
9090: 20 64 65 6c 61 79 20 77 65 20 63 61 6e 20 73 69   delay we can si
90a0: 6d 75 6c 61 74 65 20 74 68 65 20 65 66 66 65 63  mulate the effec
90b0: 74 20 6f 66 20 73 6c 6f 77 20 64 69 73 6b 20 49  t of slow disk I
90c0: 2f 4f 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  /O..*/.static in
90d0: 74 20 74 65 73 74 41 73 79 6e 63 44 65 6c 61 79  t testAsyncDelay
90e0: 28 0a 20 20 76 6f 69 64 20 2a 20 63 6c 69 65 6e  (.  void * clien
90f0: 74 44 61 74 61 2c 0a 20 20 54 63 6c 5f 49 6e 74  tData,.  Tcl_Int
9100: 65 72 70 20 2a 69 6e 74 65 72 70 2c 0a 20 20 69  erp *interp,.  i
9110: 6e 74 20 6f 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f  nt objc,.  Tcl_O
9120: 62 6a 20 2a 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d  bj *CONST objv[]
9130: 0a 29 7b 0a 20 20 69 66 28 20 6f 62 6a 63 21 3d  .){.  if( objc!=
9140: 31 20 26 26 20 6f 62 6a 63 21 3d 32 20 29 7b 0a  1 && objc!=2 ){.
9150: 20 20 20 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d      Tcl_WrongNum
9160: 41 72 67 73 28 69 6e 74 65 72 70 2c 20 31 2c 20  Args(interp, 1, 
9170: 6f 62 6a 76 2c 20 22 3f 4d 53 3f 22 29 3b 0a 20  objv, "?MS?");. 
9180: 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52     return TCL_ER
9190: 52 4f 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6f  ROR;.  }.  if( o
91a0: 62 6a 63 3d 3d 31 20 29 7b 0a 20 20 20 20 54 63  bjc==1 ){.    Tc
91b0: 6c 5f 53 65 74 4f 62 6a 52 65 73 75 6c 74 28 69  l_SetObjResult(i
91c0: 6e 74 65 72 70 2c 20 54 63 6c 5f 4e 65 77 49 6e  nterp, Tcl_NewIn
91d0: 74 4f 62 6a 28 61 73 79 6e 63 2e 69 6f 44 65 6c  tObj(async.ioDel
91e0: 61 79 29 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  ay));.  }else{. 
91f0: 20 20 20 69 6e 74 20 69 6f 44 65 6c 61 79 3b 0a     int ioDelay;.
9200: 20 20 20 20 69 66 28 20 54 63 6c 5f 47 65 74 49      if( Tcl_GetI
9210: 6e 74 46 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70  ntFromObj(interp
9220: 2c 20 6f 62 6a 76 5b 31 5d 2c 20 26 69 6f 44 65  , objv[1], &ioDe
9230: 6c 61 79 29 20 29 20 72 65 74 75 72 6e 20 54 43  lay) ) return TC
9240: 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 61 73 79  L_ERROR;.    asy
9250: 6e 63 2e 69 6f 44 65 6c 61 79 20 3d 20 69 6f 44  nc.ioDelay = ioD
9260: 65 6c 61 79 3b 0a 20 20 7d 0a 20 20 72 65 74 75  elay;.  }.  retu
9270: 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  rn TCL_OK;.}../*
9280: 0a 2a 2a 20 73 71 6c 69 74 65 33 61 73 79 6e 63  .** sqlite3async
9290: 5f 73 74 61 72 74 0a 2a 2a 0a 2a 2a 20 53 74 61  _start.**.** Sta
92a0: 72 74 20 61 20 6e 65 77 20 77 72 69 74 65 72 20  rt a new writer 
92b0: 74 68 72 65 61 64 2e 0a 2a 2f 0a 73 74 61 74 69  thread..*/.stati
92c0: 63 20 69 6e 74 20 74 65 73 74 41 73 79 6e 63 53  c int testAsyncS
92d0: 74 61 72 74 28 0a 20 20 76 6f 69 64 20 2a 20 63  tart(.  void * c
92e0: 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20 54 63 6c  lientData,.  Tcl
92f0: 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c  _Interp *interp,
9300: 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54  .  int objc,.  T
9310: 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62  cl_Obj *CONST ob
9320: 6a 76 5b 5d 0a 29 7b 0a 20 20 70 74 68 72 65 61  jv[].){.  pthrea
9330: 64 5f 74 20 78 3b 0a 20 20 69 6e 74 20 72 63 3b  d_t x;.  int rc;
9340: 0a 20 20 72 63 20 3d 20 70 74 68 72 65 61 64 5f  .  rc = pthread_
9350: 63 72 65 61 74 65 28 26 78 2c 20 30 2c 20 61 73  create(&x, 0, as
9360: 79 6e 63 57 72 69 74 65 72 54 68 72 65 61 64 2c  yncWriterThread,
9370: 20 30 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b   0);.  if( rc ){
9380: 0a 20 20 20 20 54 63 6c 5f 41 70 70 65 6e 64 52  .    Tcl_AppendR
9390: 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 22 66  esult(interp, "f
93a0: 61 69 6c 65 64 20 74 6f 20 63 72 65 61 74 65 20  ailed to create 
93b0: 74 68 65 20 74 68 72 65 61 64 22 2c 20 30 29 3b  the thread", 0);
93c0: 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  .    return TCL_
93d0: 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 70 74 68  ERROR;.  }.  pth
93e0: 72 65 61 64 5f 64 65 74 61 63 68 28 78 29 3b 0a  read_detach(x);.
93f0: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b    return TCL_OK;
9400: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 73 71 6c 69 74 65  .}../*.** sqlite
9410: 33 61 73 79 6e 63 5f 77 61 69 74 0a 2a 2a 0a 2a  3async_wait.**.*
9420: 2a 20 57 61 69 74 20 66 6f 72 20 74 68 65 20 63  * Wait for the c
9430: 75 72 72 65 6e 74 20 77 72 69 74 65 72 20 74 68  urrent writer th
9440: 72 65 61 64 20 74 6f 20 74 65 72 6d 69 6e 61 74  read to terminat
9450: 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20  e..**.** If the 
9460: 63 75 72 72 65 6e 74 20 77 72 69 74 65 72 20 74  current writer t
9470: 68 72 65 61 64 20 69 73 20 73 65 74 20 74 6f 20  hread is set to 
9480: 72 75 6e 20 66 6f 72 65 76 65 72 20 74 68 65 6e  run forever then
9490: 20 74 68 69 73 0a 2a 2a 20 63 6f 6d 6d 61 6e 64   this.** command
94a0: 20 77 6f 75 6c 64 20 62 6c 6f 63 6b 20 66 6f 72   would block for
94b0: 65 76 65 72 2e 20 20 54 6f 20 70 72 65 76 65 6e  ever.  To preven
94c0: 74 20 74 68 61 74 2c 20 61 6e 20 65 72 72 6f 72  t that, an error
94d0: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 0a 2a   is returned. .*
94e0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 74 65 73  /.static int tes
94f0: 74 41 73 79 6e 63 57 61 69 74 28 0a 20 20 76 6f  tAsyncWait(.  vo
9500: 69 64 20 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c  id * clientData,
9510: 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69  .  Tcl_Interp *i
9520: 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a  nterp,.  int obj
9530: 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f  c,.  Tcl_Obj *CO
9540: 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20  NST objv[].){.  
9550: 69 6e 74 20 63 6e 74 20 3d 20 31 30 3b 0a 20 20  int cnt = 10;.  
9560: 69 66 28 20 61 73 79 6e 63 2e 77 72 69 74 65 72  if( async.writer
9570: 48 61 6c 74 4e 6f 77 3d 3d 30 20 26 26 20 61 73  HaltNow==0 && as
9580: 79 6e 63 2e 77 72 69 74 65 72 48 61 6c 74 57 68  ync.writerHaltWh
9590: 65 6e 49 64 6c 65 3d 3d 30 20 29 7b 0a 20 20 20  enIdle==0 ){.   
95a0: 20 54 63 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c   Tcl_AppendResul
95b0: 74 28 69 6e 74 65 72 70 2c 20 22 77 6f 75 6c 64  t(interp, "would
95c0: 20 62 6c 6f 63 6b 20 66 6f 72 65 76 65 72 22 2c   block forever",
95d0: 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 20 20   (char*)0);.    
95e0: 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52  return TCL_ERROR
95f0: 3b 0a 20 20 7d 0a 0a 20 20 77 68 69 6c 65 28 20  ;.  }..  while( 
9600: 63 6e 74 2d 2d 20 26 26 20 21 70 74 68 72 65 61  cnt-- && !pthrea
9610: 64 5f 6d 75 74 65 78 5f 74 72 79 6c 6f 63 6b 28  d_mutex_trylock(
9620: 26 61 73 79 6e 63 2e 77 72 69 74 65 72 4d 75 74  &async.writerMut
9630: 65 78 29 20 29 7b 0a 20 20 20 20 70 74 68 72 65  ex) ){.    pthre
9640: 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f 63 6b 28  ad_mutex_unlock(
9650: 26 61 73 79 6e 63 2e 77 72 69 74 65 72 4d 75 74  &async.writerMut
9660: 65 78 29 3b 0a 20 20 20 20 73 63 68 65 64 5f 79  ex);.    sched_y
9670: 69 65 6c 64 28 29 3b 0a 20 20 7d 0a 20 20 69 66  ield();.  }.  if
9680: 28 20 63 6e 74 3e 3d 30 20 29 7b 0a 20 20 20 20  ( cnt>=0 ){.    
9690: 41 53 59 4e 43 5f 54 52 41 43 45 28 28 22 57 41  ASYNC_TRACE(("WA
96a0: 49 54 5c 6e 22 29 29 3b 0a 20 20 20 20 70 74 68  IT\n"));.    pth
96b0: 72 65 61 64 5f 6d 75 74 65 78 5f 6c 6f 63 6b 28  read_mutex_lock(
96c0: 26 61 73 79 6e 63 2e 71 75 65 75 65 4d 75 74 65  &async.queueMute
96d0: 78 29 3b 0a 20 20 20 20 70 74 68 72 65 61 64 5f  x);.    pthread_
96e0: 63 6f 6e 64 5f 62 72 6f 61 64 63 61 73 74 28 26  cond_broadcast(&
96f0: 61 73 79 6e 63 2e 71 75 65 75 65 53 69 67 6e 61  async.queueSigna
9700: 6c 29 3b 0a 20 20 20 20 70 74 68 72 65 61 64 5f  l);.    pthread_
9710: 6d 75 74 65 78 5f 75 6e 6c 6f 63 6b 28 26 61 73  mutex_unlock(&as
9720: 79 6e 63 2e 71 75 65 75 65 4d 75 74 65 78 29 3b  ync.queueMutex);
9730: 0a 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75 74  .    pthread_mut
9740: 65 78 5f 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 77  ex_lock(&async.w
9750: 72 69 74 65 72 4d 75 74 65 78 29 3b 0a 20 20 20  riterMutex);.   
9760: 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 75   pthread_mutex_u
9770: 6e 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 77 72 69  nlock(&async.wri
9780: 74 65 72 4d 75 74 65 78 29 3b 0a 20 20 7d 65 6c  terMutex);.  }el
9790: 73 65 7b 0a 20 20 20 20 41 53 59 4e 43 5f 54 52  se{.    ASYNC_TR
97a0: 41 43 45 28 28 22 4e 4f 2d 57 41 49 54 5c 6e 22  ACE(("NO-WAIT\n"
97b0: 29 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  ));.  }.  return
97c0: 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 0a 23 65 6e   TCL_OK;.}...#en
97d0: 64 69 66 20 20 2f 2a 20 4f 53 5f 55 4e 49 58 20  dif  /* OS_UNIX 
97e0: 61 6e 64 20 53 51 4c 49 54 45 5f 54 48 52 45 41  and SQLITE_THREA
97f0: 44 53 41 46 45 20 61 6e 64 20 64 65 66 69 6e 65  DSAFE and define
9800: 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  d(SQLITE_ENABLE_
9810: 52 45 44 45 46 5f 49 4f 29 20 2a 2f 0a 0a 2f 2a  REDEF_IO) */../*
9820: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
9830: 20 72 65 67 69 73 74 65 72 73 20 74 68 65 20 63   registers the c
9840: 75 73 74 6f 6d 20 54 43 4c 20 63 6f 6d 6d 61 6e  ustom TCL comman
9850: 64 73 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68  ds defined in th
9860: 69 73 0a 2a 2a 20 6d 6f 64 75 6c 65 2e 20 20 54  is.** module.  T
9870: 68 69 73 20 73 68 6f 75 6c 64 20 62 65 20 74 68  his should be th
9880: 65 20 6f 6e 6c 79 20 70 72 6f 63 65 64 75 72 65  e only procedure
9890: 20 76 69 73 69 62 6c 65 20 66 72 6f 6d 20 6f 75   visible from ou
98a0: 74 73 69 64 65 0a 2a 2a 20 6f 66 20 74 68 69 73  tside.** of this
98b0: 20 6d 6f 64 75 6c 65 2e 0a 2a 2f 0a 69 6e 74 20   module..*/.int 
98c0: 53 71 6c 69 74 65 74 65 73 74 61 73 79 6e 63 5f  Sqlitetestasync_
98d0: 49 6e 69 74 28 54 63 6c 5f 49 6e 74 65 72 70 20  Init(Tcl_Interp 
98e0: 2a 69 6e 74 65 72 70 29 7b 0a 23 69 66 20 4f 53  *interp){.#if OS
98f0: 5f 55 4e 49 58 20 26 26 20 53 51 4c 49 54 45 5f  _UNIX && SQLITE_
9900: 54 48 52 45 41 44 53 41 46 45 20 26 26 20 64 65  THREADSAFE && de
9910: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41  fined(SQLITE_ENA
9920: 42 4c 45 5f 52 45 44 45 46 5f 49 4f 29 0a 20 20  BLE_REDEF_IO).  
9930: 54 63 6c 5f 43 72 65 61 74 65 4f 62 6a 43 6f 6d  Tcl_CreateObjCom
9940: 6d 61 6e 64 28 69 6e 74 65 72 70 2c 22 73 71 6c  mand(interp,"sql
9950: 69 74 65 33 61 73 79 6e 63 5f 65 6e 61 62 6c 65  ite3async_enable
9960: 22 2c 74 65 73 74 41 73 79 6e 63 45 6e 61 62 6c  ",testAsyncEnabl
9970: 65 2c 30 2c 30 29 3b 0a 20 20 54 63 6c 5f 43 72  e,0,0);.  Tcl_Cr
9980: 65 61 74 65 4f 62 6a 43 6f 6d 6d 61 6e 64 28 69  eateObjCommand(i
9990: 6e 74 65 72 70 2c 22 73 71 6c 69 74 65 33 61 73  nterp,"sqlite3as
99a0: 79 6e 63 5f 68 61 6c 74 22 2c 74 65 73 74 41 73  ync_halt",testAs
99b0: 79 6e 63 48 61 6c 74 2c 30 2c 30 29 3b 0a 20 20  yncHalt,0,0);.  
99c0: 54 63 6c 5f 43 72 65 61 74 65 4f 62 6a 43 6f 6d  Tcl_CreateObjCom
99d0: 6d 61 6e 64 28 69 6e 74 65 72 70 2c 22 73 71 6c  mand(interp,"sql
99e0: 69 74 65 33 61 73 79 6e 63 5f 64 65 6c 61 79 22  ite3async_delay"
99f0: 2c 74 65 73 74 41 73 79 6e 63 44 65 6c 61 79 2c  ,testAsyncDelay,
9a00: 30 2c 30 29 3b 0a 20 20 54 63 6c 5f 43 72 65 61  0,0);.  Tcl_Crea
9a10: 74 65 4f 62 6a 43 6f 6d 6d 61 6e 64 28 69 6e 74  teObjCommand(int
9a20: 65 72 70 2c 22 73 71 6c 69 74 65 33 61 73 79 6e  erp,"sqlite3asyn
9a30: 63 5f 73 74 61 72 74 22 2c 74 65 73 74 41 73 79  c_start",testAsy
9a40: 6e 63 53 74 61 72 74 2c 30 2c 30 29 3b 0a 20 20  ncStart,0,0);.  
9a50: 54 63 6c 5f 43 72 65 61 74 65 4f 62 6a 43 6f 6d  Tcl_CreateObjCom
9a60: 6d 61 6e 64 28 69 6e 74 65 72 70 2c 22 73 71 6c  mand(interp,"sql
9a70: 69 74 65 33 61 73 79 6e 63 5f 77 61 69 74 22 2c  ite3async_wait",
9a80: 74 65 73 74 41 73 79 6e 63 57 61 69 74 2c 30 2c  testAsyncWait,0,
9a90: 30 29 3b 0a 20 20 54 63 6c 5f 4c 69 6e 6b 56 61  0);.  Tcl_LinkVa
9aa0: 72 28 69 6e 74 65 72 70 2c 20 22 73 71 6c 69 74  r(interp, "sqlit
9ab0: 65 33 61 73 79 6e 63 5f 74 72 61 63 65 22 2c 0a  e3async_trace",.
9ac0: 20 20 20 20 20 20 28 63 68 61 72 2a 29 26 73 71        (char*)&sq
9ad0: 6c 69 74 65 33 61 73 79 6e 63 5f 74 72 61 63 65  lite3async_trace
9ae0: 2c 20 54 43 4c 5f 4c 49 4e 4b 5f 49 4e 54 29 3b  , TCL_LINK_INT);
9af0: 0a 23 65 6e 64 69 66 20 20 2f 2a 20 4f 53 5f 55  .#endif  /* OS_U
9b00: 4e 49 58 20 61 6e 64 20 53 51 4c 49 54 45 5f 54  NIX and SQLITE_T
9b10: 48 52 45 41 44 53 41 46 45 20 61 6e 64 20 64 65  HREADSAFE and de
9b20: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41  fined(SQLITE_ENA
9b30: 42 4c 45 5f 52 45 44 45 46 5f 49 4f 29 20 2a 2f  BLE_REDEF_IO) */
9b40: 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b  .  return TCL_OK
9b50: 3b 0a 7d 0a                                      ;.}.