/ Hex Artifact Content
Login

Artifact dcb562dc81bf6851294b9260c8b61971169d5707:


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 46 69 6c 65 43 6f 6e 74 72  t asyncFileContr
52b0: 6f 6c 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  ol(sqlite3_file 
52c0: 2a 69 64 2c 20 69 6e 74 20 6f 70 2c 20 76 6f 69  *id, int op, voi
52d0: 64 20 2a 70 41 72 67 29 7b 0a 20 20 72 65 74 75  d *pArg){.  retu
52e0: 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b  rn SQLITE_ERROR;
52f0: 0a 7d 0a 0a 2f 2a 20 0a 2a 2a 20 52 65 74 75 72  .}../* .** Retur
5300: 6e 20 74 68 65 20 64 65 76 69 63 65 20 63 68 61  n the device cha
5310: 72 61 63 74 65 72 69 73 74 69 63 73 20 61 6e 64  racteristics and
5320: 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 6f 66 20   sector-size of 
5330: 74 68 65 20 64 65 76 69 63 65 2e 20 49 74 0a 2a  the device. It.*
5340: 2a 20 69 73 20 6e 6f 74 20 74 72 69 63 6b 79 20  * is not tricky 
5350: 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65  to implement the
5360: 73 65 20 63 6f 72 72 65 63 74 6c 79 2c 20 61 73  se correctly, as
5370: 20 74 68 69 73 20 62 61 63 6b 65 6e 64 20 6d 69   this backend mi
5380: 67 68 74 20 0a 2a 2a 20 6e 6f 74 20 68 61 76 65  ght .** not have
5390: 20 61 6e 20 6f 70 65 6e 20 66 69 6c 65 20 68 61   an open file ha
53a0: 6e 64 6c 65 20 61 74 20 74 68 69 73 20 70 6f 69  ndle at this poi
53b0: 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  nt..*/.static in
53c0: 74 20 61 73 79 6e 63 53 65 63 74 6f 72 53 69 7a  t asyncSectorSiz
53d0: 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a  e(sqlite3_file *
53e0: 70 46 69 6c 65 29 7b 0a 20 20 72 65 74 75 72 6e  pFile){.  return
53f0: 20 35 31 32 3b 0a 7d 0a 73 74 61 74 69 63 20 69   512;.}.static i
5400: 6e 74 20 61 73 79 6e 63 44 65 76 69 63 65 43 68  nt asyncDeviceCh
5410: 61 72 61 63 74 65 72 69 73 74 69 63 73 28 73 71  aracteristics(sq
5420: 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c  lite3_file *pFil
5430: 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a  e){.  return 0;.
5440: 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20  }../*.** Open a 
5450: 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  file..*/.static 
5460: 69 6e 74 20 61 73 79 6e 63 4f 70 65 6e 28 0a 20  int asyncOpen(. 
5470: 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 41   sqlite3_vfs *pA
5480: 73 79 6e 63 56 66 73 2c 0a 20 20 63 6f 6e 73 74  syncVfs,.  const
5490: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 0a 20 20   char *zName,.  
54a0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46  sqlite3_file *pF
54b0: 69 6c 65 2c 0a 20 20 69 6e 74 20 66 6c 61 67 73  ile,.  int flags
54c0: 2c 0a 20 20 69 6e 74 20 2a 70 4f 75 74 46 6c 61  ,.  int *pOutFla
54d0: 67 73 0a 29 7b 0a 20 20 73 74 61 74 69 63 20 73  gs.){.  static s
54e0: 71 6c 69 74 65 33 5f 69 6f 5f 6d 65 74 68 6f 64  qlite3_io_method
54f0: 73 20 61 73 79 6e 63 5f 6d 65 74 68 6f 64 73 20  s async_methods 
5500: 3d 20 7b 0a 20 20 20 20 31 2c 20 20 20 20 20 20  = {.    1,      
5510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5520: 20 20 20 20 20 20 20 20 20 2f 2a 20 69 56 65 72           /* iVer
5530: 73 69 6f 6e 20 2a 2f 0a 20 20 20 20 61 73 79 6e  sion */.    asyn
5540: 63 43 6c 6f 73 65 2c 20 20 20 20 20 20 20 20 20  cClose,         
5550: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5560: 78 43 6c 6f 73 65 20 2a 2f 0a 20 20 20 20 61 73  xClose */.    as
5570: 79 6e 63 52 65 61 64 2c 20 20 20 20 20 20 20 20  yncRead,        
5580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5590: 2a 20 78 52 65 61 64 20 2a 2f 0a 20 20 20 20 61  * xRead */.    a
55a0: 73 79 6e 63 57 72 69 74 65 2c 20 20 20 20 20 20  syncWrite,      
55b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
55c0: 2f 2a 20 78 57 72 69 74 65 20 2a 2f 0a 20 20 20  /* xWrite */.   
55d0: 20 61 73 79 6e 63 54 72 75 6e 63 61 74 65 2c 20   asyncTruncate, 
55e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
55f0: 20 20 2f 2a 20 78 54 72 75 6e 63 61 74 65 20 2a    /* xTruncate *
5600: 2f 0a 20 20 20 20 61 73 79 6e 63 53 79 6e 63 2c  /.    asyncSync,
5610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5620: 20 20 20 20 20 20 20 2f 2a 20 78 53 79 6e 63 20         /* xSync 
5630: 2a 2f 0a 20 20 20 20 61 73 79 6e 63 46 69 6c 65  */.    asyncFile
5640: 53 69 7a 65 2c 20 20 20 20 20 20 20 20 20 20 20  Size,           
5650: 20 20 20 20 20 20 20 20 2f 2a 20 78 46 69 6c 65          /* xFile
5660: 53 69 7a 65 20 2a 2f 0a 20 20 20 20 61 73 79 6e  Size */.    asyn
5670: 63 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20 20  cLock,          
5680: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5690: 78 4c 6f 63 6b 20 2a 2f 0a 20 20 20 20 61 73 79  xLock */.    asy
56a0: 6e 63 55 6e 6c 6f 63 6b 2c 20 20 20 20 20 20 20  ncUnlock,       
56b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
56c0: 20 78 55 6e 6c 6f 63 6b 20 2a 2f 0a 20 20 20 20   xUnlock */.    
56d0: 61 73 79 6e 63 43 68 65 63 6b 52 65 73 65 72 76  asyncCheckReserv
56e0: 65 64 4c 6f 63 6b 2c 20 20 20 20 20 20 20 20 20  edLock,         
56f0: 20 2f 2a 20 78 43 68 65 63 6b 52 65 73 65 72 76   /* xCheckReserv
5700: 65 64 4c 6f 63 6b 20 2a 2f 0a 20 20 20 20 61 73  edLock */.    as
5710: 79 6e 63 46 69 6c 65 43 6f 6e 74 72 6f 6c 2c 20  yncFileControl, 
5720: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5730: 2a 20 78 46 69 6c 65 43 6f 6e 74 72 6f 6c 20 2a  * xFileControl *
5740: 2f 0a 20 20 20 20 61 73 79 6e 63 53 65 63 74 6f  /.    asyncSecto
5750: 72 53 69 7a 65 2c 20 20 20 20 20 20 20 20 20 20  rSize,          
5760: 20 20 20 20 20 20 20 2f 2a 20 78 53 65 63 74 6f         /* xSecto
5770: 72 53 69 7a 65 20 2a 2f 0a 20 20 20 20 61 73 79  rSize */.    asy
5780: 6e 63 44 65 76 69 63 65 43 68 61 72 61 63 74 65  ncDeviceCharacte
5790: 72 69 73 74 69 63 73 20 20 20 20 20 20 20 2f 2a  ristics       /*
57a0: 20 78 44 65 76 69 63 65 43 68 61 72 61 63 74 65   xDeviceCharacte
57b0: 72 69 73 74 69 63 73 20 2a 2f 0a 20 20 7d 3b 0a  ristics */.  };.
57c0: 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a  .  sqlite3_vfs *
57d0: 70 56 66 73 20 3d 20 28 73 71 6c 69 74 65 33 5f  pVfs = (sqlite3_
57e0: 76 66 73 20 2a 29 70 41 73 79 6e 63 56 66 73 2d  vfs *)pAsyncVfs-
57f0: 3e 70 41 70 70 44 61 74 61 3b 0a 20 20 41 73 79  >pAppData;.  Asy
5800: 6e 63 46 69 6c 65 20 2a 70 20 3d 20 28 41 73 79  ncFile *p = (Asy
5810: 6e 63 46 69 6c 65 20 2a 29 70 46 69 6c 65 3b 0a  ncFile *)pFile;.
5820: 20 20 69 6e 74 20 6e 4e 61 6d 65 20 3d 20 73 74    int nName = st
5830: 72 6c 65 6e 28 7a 4e 61 6d 65 29 3b 3b 0a 20 20  rlen(zName);;.  
5840: 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 6e 42  int rc;.  int nB
5850: 79 74 65 3b 0a 20 20 41 73 79 6e 63 46 69 6c 65  yte;.  AsyncFile
5860: 44 61 74 61 20 2a 70 44 61 74 61 3b 0a 0a 20 20  Data *pData;..  
5870: 6e 42 79 74 65 20 3d 20 28 0a 20 20 20 20 73 69  nByte = (.    si
5880: 7a 65 6f 66 28 41 73 79 6e 63 46 69 6c 65 44 61  zeof(AsyncFileDa
5890: 74 61 29 20 2b 20 20 20 20 20 20 20 20 2f 2a 20  ta) +        /* 
58a0: 41 73 79 6e 63 46 69 6c 65 44 61 74 61 20 73 74  AsyncFileData st
58b0: 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 20 20 32  ructure */.    2
58c0: 20 2a 20 70 56 66 73 2d 3e 73 7a 4f 73 46 69 6c   * pVfs->szOsFil
58d0: 65 20 2b 20 20 20 20 20 20 20 20 20 20 20 2f 2a  e +           /*
58e0: 20 41 73 79 6e 63 46 69 6c 65 44 61 74 61 2e 7a   AsyncFileData.z
58f0: 4e 61 6d 65 20 2a 2f 0a 20 20 20 20 6e 4e 61 6d  Name */.    nNam
5900: 65 20 2b 20 31 20 20 20 20 20 20 20 20 20 20 20  e + 1           
5910: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 73             /* As
5920: 79 6e 63 46 69 6c 65 44 61 74 61 2e 70 42 61 73  yncFileData.pBas
5930: 65 52 65 61 64 20 61 6e 64 20 70 42 61 73 65 57  eRead and pBaseW
5940: 72 69 74 65 20 2a 2f 0a 20 20 29 3b 0a 20 20 70  rite */.  );.  p
5950: 44 61 74 61 20 3d 20 73 71 6c 69 74 65 33 5f 6d  Data = sqlite3_m
5960: 61 6c 6c 6f 63 28 6e 42 79 74 65 29 3b 0a 20 20  alloc(nByte);.  
5970: 69 66 28 20 21 70 44 61 74 61 20 29 7b 0a 20 20  if( !pData ){.  
5980: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
5990: 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 6d 65 6d  NOMEM;.  }.  mem
59a0: 73 65 74 28 70 44 61 74 61 2c 20 30 2c 20 6e 42  set(pData, 0, nB
59b0: 79 74 65 29 3b 0a 20 20 70 44 61 74 61 2d 3e 7a  yte);.  pData->z
59c0: 4e 61 6d 65 20 3d 20 28 63 68 61 72 20 2a 29 26  Name = (char *)&
59d0: 70 44 61 74 61 5b 31 5d 3b 0a 20 20 70 44 61 74  pData[1];.  pDat
59e0: 61 2d 3e 6e 4e 61 6d 65 20 3d 20 6e 4e 61 6d 65  a->nName = nName
59f0: 3b 0a 20 20 70 44 61 74 61 2d 3e 70 42 61 73 65  ;.  pData->pBase
5a00: 52 65 61 64 20 3d 20 28 73 71 6c 69 74 65 33 5f  Read = (sqlite3_
5a10: 66 69 6c 65 20 2a 29 26 70 44 61 74 61 2d 3e 7a  file *)&pData->z
5a20: 4e 61 6d 65 5b 6e 4e 61 6d 65 2b 31 5d 3b 0a 20  Name[nName+1];. 
5a30: 20 70 44 61 74 61 2d 3e 70 42 61 73 65 57 72 69   pData->pBaseWri
5a40: 74 65 20 3d 20 28 73 71 6c 69 74 65 33 5f 66 69  te = (sqlite3_fi
5a50: 6c 65 20 2a 29 26 70 44 61 74 61 2d 3e 7a 4e 61  le *)&pData->zNa
5a60: 6d 65 5b 6e 4e 61 6d 65 2b 31 2b 70 56 66 73 2d  me[nName+1+pVfs-
5a70: 3e 73 7a 4f 73 46 69 6c 65 5d 3b 0a 20 20 6d 65  >szOsFile];.  me
5a80: 6d 63 70 79 28 70 44 61 74 61 2d 3e 7a 4e 61 6d  mcpy(pData->zNam
5a90: 65 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 2b  e, zName, nName+
5aa0: 31 29 3b 0a 0a 20 20 69 66 28 20 66 6c 61 67 73  1);..  if( flags
5ab0: 26 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 45 58 43  &SQLITE_OPEN_EXC
5ac0: 4c 55 53 49 56 45 20 29 7b 0a 20 20 20 20 72 63  LUSIVE ){.    rc
5ad0: 20 3d 20 61 64 64 4e 65 77 41 73 79 6e 63 57 72   = addNewAsyncWr
5ae0: 69 74 65 28 70 44 61 74 61 2c 20 41 53 59 4e 43  ite(pData, ASYNC
5af0: 5f 4f 50 45 4e 45 58 43 4c 55 53 49 56 45 2c 20  _OPENEXCLUSIVE, 
5b00: 28 69 36 34 29 66 6c 61 67 73 2c 20 30 2c 20 30  (i64)flags, 0, 0
5b10: 29 3b 0a 20 20 20 20 69 66 28 20 70 4f 75 74 46  );.    if( pOutF
5b20: 6c 61 67 73 20 29 20 2a 70 4f 75 74 46 6c 61 67  lags ) *pOutFlag
5b30: 73 20 3d 20 66 6c 61 67 73 3b 0a 20 20 7d 65 6c  s = flags;.  }el
5b40: 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  se{.    rc = sql
5b50: 69 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c  ite3OsOpen(pVfs,
5b60: 20 7a 4e 61 6d 65 2c 20 70 44 61 74 61 2d 3e 70   zName, pData->p
5b70: 42 61 73 65 52 65 61 64 2c 20 66 6c 61 67 73 2c  BaseRead, flags,
5b80: 20 70 4f 75 74 46 6c 61 67 73 29 3b 0a 20 20 20   pOutFlags);.   
5b90: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
5ba0: 4f 4b 20 26 26 20 28 28 2a 70 4f 75 74 46 6c 61  OK && ((*pOutFla
5bb0: 67 73 29 26 53 51 4c 49 54 45 5f 4f 50 45 4e 5f  gs)&SQLITE_OPEN_
5bc0: 52 45 41 44 57 52 49 54 45 29 20 29 7b 0a 20 20  READWRITE) ){.  
5bd0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
5be0: 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20 7a 4e 61  OsOpen(pVfs, zNa
5bf0: 6d 65 2c 20 70 44 61 74 61 2d 3e 70 42 61 73 65  me, pData->pBase
5c00: 57 72 69 74 65 2c 20 66 6c 61 67 73 2c 20 30 29  Write, flags, 0)
5c10: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69  ;.    }.  }..  i
5c20: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
5c30: 20 29 7b 0a 20 20 20 20 70 2d 3e 70 4d 65 74 68   ){.    p->pMeth
5c40: 6f 64 20 3d 20 26 61 73 79 6e 63 5f 6d 65 74 68  od = &async_meth
5c50: 6f 64 73 3b 0a 20 20 20 20 70 2d 3e 70 44 61 74  ods;.    p->pDat
5c60: 61 20 3d 20 70 44 61 74 61 3b 0a 20 20 20 20 69  a = pData;.    i
5c70: 6e 63 72 4f 70 65 6e 46 69 6c 65 43 6f 75 6e 74  ncrOpenFileCount
5c80: 28 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ();.  }else{.   
5c90: 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28   sqlite3OsClose(
5ca0: 70 44 61 74 61 2d 3e 70 42 61 73 65 52 65 61 64  pData->pBaseRead
5cb0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73  );.    sqlite3Os
5cc0: 43 6c 6f 73 65 28 70 44 61 74 61 2d 3e 70 42 61  Close(pData->pBa
5cd0: 73 65 57 72 69 74 65 29 3b 0a 20 20 20 20 73 71  seWrite);.    sq
5ce0: 6c 69 74 65 33 5f 66 72 65 65 28 70 44 61 74 61  lite3_free(pData
5cf0: 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e  );.  }..  return
5d00: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6d   rc;.}../*.** Im
5d10: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
5d20: 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 74 65 2e  sqlite3OsDelete.
5d30: 20 41 64 64 20 61 6e 20 65 6e 74 72 79 20 74 6f   Add an entry to
5d40: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20   the end of the 
5d50: 0a 2a 2a 20 77 72 69 74 65 2d 6f 70 20 71 75 65  .** write-op que
5d60: 75 65 20 74 6f 20 70 65 72 66 6f 72 6d 20 74 68  ue to perform th
5d70: 65 20 64 65 6c 65 74 65 2e 0a 2a 2f 0a 73 74 61  e delete..*/.sta
5d80: 74 69 63 20 69 6e 74 20 61 73 79 6e 63 44 65 6c  tic int asyncDel
5d90: 65 74 65 28 73 71 6c 69 74 65 33 5f 76 66 73 20  ete(sqlite3_vfs 
5da0: 2a 70 41 73 79 6e 63 56 66 73 2c 20 63 6f 6e 73  *pAsyncVfs, cons
5db0: 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74 20 73  t char *z, int s
5dc0: 79 6e 63 44 69 72 29 7b 0a 20 20 72 65 74 75 72  yncDir){.  retur
5dd0: 6e 20 61 64 64 4e 65 77 41 73 79 6e 63 57 72 69  n addNewAsyncWri
5de0: 74 65 28 30 2c 20 41 53 59 4e 43 5f 44 45 4c 45  te(0, ASYNC_DELE
5df0: 54 45 2c 20 73 79 6e 63 44 69 72 2c 20 73 74 72  TE, syncDir, str
5e00: 6c 65 6e 28 7a 29 2b 31 2c 20 7a 29 3b 0a 7d 0a  len(z)+1, z);.}.
5e10: 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74  ./*.** Implement
5e20: 61 74 69 6f 6e 20 6f 66 20 73 71 6c 69 74 65 33  ation of sqlite3
5e30: 4f 73 41 63 63 65 73 73 2e 20 54 68 69 73 20 6d  OsAccess. This m
5e40: 65 74 68 6f 64 20 68 6f 6c 64 73 20 74 68 65 20  ethod holds the 
5e50: 6d 75 74 65 78 20 66 72 6f 6d 0a 2a 2a 20 73 74  mutex from.** st
5e60: 61 72 74 20 74 6f 20 66 69 6e 69 73 68 2e 0a 2a  art to finish..*
5e70: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 73 79  /.static int asy
5e80: 6e 63 41 63 63 65 73 73 28 73 71 6c 69 74 65 33  ncAccess(sqlite3
5e90: 5f 76 66 73 20 2a 70 41 73 79 6e 63 56 66 73 2c  _vfs *pAsyncVfs,
5ea0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61   const char *zNa
5eb0: 6d 65 2c 20 69 6e 74 20 66 6c 61 67 73 29 7b 0a  me, int flags){.
5ec0: 20 20 69 6e 74 20 72 65 74 3b 0a 20 20 41 73 79    int ret;.  Asy
5ed0: 6e 63 57 72 69 74 65 20 2a 70 3b 0a 20 20 73 71  ncWrite *p;.  sq
5ee0: 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20  lite3_vfs *pVfs 
5ef0: 3d 20 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a  = (sqlite3_vfs *
5f00: 29 70 41 73 79 6e 63 56 66 73 2d 3e 70 41 70 70  )pAsyncVfs->pApp
5f10: 44 61 74 61 3b 0a 0a 20 20 61 73 73 65 72 74 28  Data;..  assert(
5f20: 66 6c 61 67 73 3d 3d 53 51 4c 49 54 45 5f 41 43  flags==SQLITE_AC
5f30: 43 45 53 53 5f 52 45 41 44 57 52 49 54 45 20 0a  CESS_READWRITE .
5f40: 20 20 20 20 20 20 7c 7c 20 66 6c 61 67 73 3d 3d        || flags==
5f50: 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 52 45  SQLITE_ACCESS_RE
5f60: 41 44 20 0a 20 20 20 20 20 20 7c 7c 20 66 6c 61  AD .      || fla
5f70: 67 73 3d 3d 53 51 4c 49 54 45 5f 41 43 43 45 53  gs==SQLITE_ACCES
5f80: 53 5f 45 58 49 53 54 53 20 0a 20 20 29 3b 0a 0a  S_EXISTS .  );..
5f90: 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f    pthread_mutex_
5fa0: 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 71 75 65 75  lock(&async.queu
5fb0: 65 4d 75 74 65 78 29 3b 0a 20 20 72 65 74 20 3d  eMutex);.  ret =
5fc0: 20 73 71 6c 69 74 65 33 4f 73 41 63 63 65 73 73   sqlite3OsAccess
5fd0: 28 70 56 66 73 2c 20 7a 4e 61 6d 65 2c 20 66 6c  (pVfs, zName, fl
5fe0: 61 67 73 29 3b 0a 20 20 69 66 28 20 66 6c 61 67  ags);.  if( flag
5ff0: 73 3d 3d 53 51 4c 49 54 45 5f 41 43 43 45 53 53  s==SQLITE_ACCESS
6000: 5f 45 58 49 53 54 53 20 29 7b 0a 20 20 20 20 66  _EXISTS ){.    f
6010: 6f 72 28 70 3d 61 73 79 6e 63 2e 70 51 75 65 75  or(p=async.pQueu
6020: 65 46 69 72 73 74 3b 20 70 3b 20 70 20 3d 20 70  eFirst; p; p = p
6030: 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20  ->pNext){.      
6040: 69 66 28 20 70 2d 3e 6f 70 3d 3d 41 53 59 4e 43  if( p->op==ASYNC
6050: 5f 44 45 4c 45 54 45 20 26 26 20 30 3d 3d 73 74  _DELETE && 0==st
6060: 72 63 6d 70 28 70 2d 3e 7a 42 75 66 2c 20 7a 4e  rcmp(p->zBuf, zN
6070: 61 6d 65 29 20 29 7b 0a 20 20 20 20 20 20 20 20  ame) ){.        
6080: 72 65 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d  ret = 0;.      }
6090: 65 6c 73 65 20 69 66 28 20 70 2d 3e 6f 70 3d 3d  else if( p->op==
60a0: 41 53 59 4e 43 5f 4f 50 45 4e 45 58 43 4c 55 53  ASYNC_OPENEXCLUS
60b0: 49 56 45 20 0a 20 20 20 20 20 20 20 20 20 20 20  IVE .           
60c0: 20 20 26 26 20 30 3d 3d 73 74 72 63 6d 70 28 70    && 0==strcmp(p
60d0: 2d 3e 70 46 69 6c 65 44 61 74 61 2d 3e 7a 4e 61  ->pFileData->zNa
60e0: 6d 65 2c 20 7a 4e 61 6d 65 29 20 0a 20 20 20 20  me, zName) .    
60f0: 20 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74    ){.        ret
6100: 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20   = 1;.      }.  
6110: 20 20 7d 0a 20 20 7d 0a 20 20 41 53 59 4e 43 5f    }.  }.  ASYNC_
6120: 54 52 41 43 45 28 28 22 41 43 43 45 53 53 28 25  TRACE(("ACCESS(%
6130: 73 29 3a 20 25 73 20 3d 20 25 64 5c 6e 22 2c 20  s): %s = %d\n", 
6140: 0a 20 20 20 20 66 6c 61 67 73 3d 3d 53 51 4c 49  .    flags==SQLI
6150: 54 45 5f 41 43 43 45 53 53 5f 52 45 41 44 57 52  TE_ACCESS_READWR
6160: 49 54 45 3f 22 72 65 61 64 2d 77 72 69 74 65 22  ITE?"read-write"
6170: 3a 0a 20 20 20 20 66 6c 61 67 73 3d 3d 53 51 4c  :.    flags==SQL
6180: 49 54 45 5f 41 43 43 45 53 53 5f 52 45 41 44 3f  ITE_ACCESS_READ?
6190: 22 72 65 61 64 22 3a 22 65 78 69 73 74 73 22 0a  "read":"exists".
61a0: 20 20 20 20 2c 20 7a 4e 61 6d 65 2c 20 72 65 74      , zName, ret
61b0: 29 0a 20 20 29 3b 0a 20 20 70 74 68 72 65 61 64  ).  );.  pthread
61c0: 5f 6d 75 74 65 78 5f 75 6e 6c 6f 63 6b 28 26 61  _mutex_unlock(&a
61d0: 73 79 6e 63 2e 71 75 65 75 65 4d 75 74 65 78 29  sync.queueMutex)
61e0: 3b 0a 20 20 72 65 74 75 72 6e 20 72 65 74 3b 0a  ;.  return ret;.
61f0: 7d 0a 0a 73 74 61 74 69 63 20 69 6e 74 20 61 73  }..static int as
6200: 79 6e 63 47 65 74 54 65 6d 70 4e 61 6d 65 28 73  yncGetTempName(s
6210: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 41 73 79  qlite3_vfs *pAsy
6220: 6e 63 56 66 73 2c 20 63 68 61 72 20 2a 7a 42 75  ncVfs, char *zBu
6230: 66 4f 75 74 29 7b 0a 20 20 73 71 6c 69 74 65 33  fOut){.  sqlite3
6240: 5f 76 66 73 20 2a 70 56 66 73 20 3d 20 28 73 71  _vfs *pVfs = (sq
6250: 6c 69 74 65 33 5f 76 66 73 20 2a 29 70 41 73 79  lite3_vfs *)pAsy
6260: 6e 63 56 66 73 2d 3e 70 41 70 70 44 61 74 61 3b  ncVfs->pAppData;
6270: 0a 20 20 72 65 74 75 72 6e 20 70 56 66 73 2d 3e  .  return pVfs->
6280: 78 47 65 74 54 65 6d 70 4e 61 6d 65 28 70 56 66  xGetTempName(pVf
6290: 73 2c 20 7a 42 75 66 4f 75 74 29 3b 0a 7d 0a 73  s, zBufOut);.}.s
62a0: 74 61 74 69 63 20 69 6e 74 20 61 73 79 6e 63 46  tatic int asyncF
62b0: 75 6c 6c 50 61 74 68 6e 61 6d 65 28 0a 20 20 73  ullPathname(.  s
62c0: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 41 73 79  qlite3_vfs *pAsy
62d0: 6e 63 56 66 73 2c 20 0a 20 20 63 6f 6e 73 74 20  ncVfs, .  const 
62e0: 63 68 61 72 20 2a 7a 50 61 74 68 2c 20 0a 20 20  char *zPath, .  
62f0: 63 68 61 72 20 2a 7a 50 61 74 68 4f 75 74 0a 29  char *zPathOut.)
6300: 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20  {.  sqlite3_vfs 
6310: 2a 70 56 66 73 20 3d 20 28 73 71 6c 69 74 65 33  *pVfs = (sqlite3
6320: 5f 76 66 73 20 2a 29 70 41 73 79 6e 63 56 66 73  _vfs *)pAsyncVfs
6330: 2d 3e 70 41 70 70 44 61 74 61 3b 0a 20 20 72 65  ->pAppData;.  re
6340: 74 75 72 6e 20 73 71 6c 69 74 65 33 4f 73 46 75  turn sqlite3OsFu
6350: 6c 6c 50 61 74 68 6e 61 6d 65 28 70 56 66 73 2c  llPathname(pVfs,
6360: 20 7a 50 61 74 68 2c 20 7a 50 61 74 68 4f 75 74   zPath, zPathOut
6370: 29 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64  );.}.static void
6380: 20 2a 61 73 79 6e 63 44 6c 4f 70 65 6e 28 73 71   *asyncDlOpen(sq
6390: 6c 69 74 65 33 5f 76 66 73 20 2a 70 41 73 79 6e  lite3_vfs *pAsyn
63a0: 63 56 66 73 2c 20 63 6f 6e 73 74 20 63 68 61 72  cVfs, const char
63b0: 20 2a 7a 50 61 74 68 29 7b 0a 20 20 73 71 6c 69   *zPath){.  sqli
63c0: 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20  te3_vfs *pVfs = 
63d0: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 29 70  (sqlite3_vfs *)p
63e0: 41 73 79 6e 63 56 66 73 2d 3e 70 41 70 70 44 61  AsyncVfs->pAppDa
63f0: 74 61 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 66  ta;.  return pVf
6400: 73 2d 3e 78 44 6c 4f 70 65 6e 28 70 56 66 73 2c  s->xDlOpen(pVfs,
6410: 20 7a 50 61 74 68 29 3b 0a 7d 0a 73 74 61 74 69   zPath);.}.stati
6420: 63 20 76 6f 69 64 20 61 73 79 6e 63 44 6c 45 72  c void asyncDlEr
6430: 72 6f 72 28 73 71 6c 69 74 65 33 5f 76 66 73 20  ror(sqlite3_vfs 
6440: 2a 70 41 73 79 6e 63 56 66 73 2c 20 69 6e 74 20  *pAsyncVfs, int 
6450: 6e 42 79 74 65 2c 20 63 68 61 72 20 2a 7a 45 72  nByte, char *zEr
6460: 72 4d 73 67 29 7b 0a 20 20 73 71 6c 69 74 65 33  rMsg){.  sqlite3
6470: 5f 76 66 73 20 2a 70 56 66 73 20 3d 20 28 73 71  _vfs *pVfs = (sq
6480: 6c 69 74 65 33 5f 76 66 73 20 2a 29 70 41 73 79  lite3_vfs *)pAsy
6490: 6e 63 56 66 73 2d 3e 70 41 70 70 44 61 74 61 3b  ncVfs->pAppData;
64a0: 0a 20 20 70 56 66 73 2d 3e 78 44 6c 45 72 72 6f  .  pVfs->xDlErro
64b0: 72 28 70 56 66 73 2c 20 6e 42 79 74 65 2c 20 7a  r(pVfs, nByte, z
64c0: 45 72 72 4d 73 67 29 3b 0a 7d 0a 73 74 61 74 69  ErrMsg);.}.stati
64d0: 63 20 76 6f 69 64 20 2a 61 73 79 6e 63 44 6c 53  c void *asyncDlS
64e0: 79 6d 28 0a 20 20 73 71 6c 69 74 65 33 5f 76 66  ym(.  sqlite3_vf
64f0: 73 20 2a 70 41 73 79 6e 63 56 66 73 2c 20 0a 20  s *pAsyncVfs, . 
6500: 20 76 6f 69 64 20 2a 70 48 61 6e 64 6c 65 2c 20   void *pHandle, 
6510: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
6520: 53 79 6d 62 6f 6c 0a 29 7b 0a 20 20 73 71 6c 69  Symbol.){.  sqli
6530: 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20  te3_vfs *pVfs = 
6540: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 29 70  (sqlite3_vfs *)p
6550: 41 73 79 6e 63 56 66 73 2d 3e 70 41 70 70 44 61  AsyncVfs->pAppDa
6560: 74 61 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 66  ta;.  return pVf
6570: 73 2d 3e 78 44 6c 53 79 6d 28 70 56 66 73 2c 20  s->xDlSym(pVfs, 
6580: 70 48 61 6e 64 6c 65 2c 20 7a 53 79 6d 62 6f 6c  pHandle, zSymbol
6590: 29 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64  );.}.static void
65a0: 20 61 73 79 6e 63 44 6c 43 6c 6f 73 65 28 73 71   asyncDlClose(sq
65b0: 6c 69 74 65 33 5f 76 66 73 20 2a 70 41 73 79 6e  lite3_vfs *pAsyn
65c0: 63 56 66 73 2c 20 76 6f 69 64 20 2a 70 48 61 6e  cVfs, void *pHan
65d0: 64 6c 65 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f  dle){.  sqlite3_
65e0: 76 66 73 20 2a 70 56 66 73 20 3d 20 28 73 71 6c  vfs *pVfs = (sql
65f0: 69 74 65 33 5f 76 66 73 20 2a 29 70 41 73 79 6e  ite3_vfs *)pAsyn
6600: 63 56 66 73 2d 3e 70 41 70 70 44 61 74 61 3b 0a  cVfs->pAppData;.
6610: 20 20 70 56 66 73 2d 3e 78 44 6c 43 6c 6f 73 65    pVfs->xDlClose
6620: 28 70 56 66 73 2c 20 70 48 61 6e 64 6c 65 29 3b  (pVfs, pHandle);
6630: 0a 7d 0a 73 74 61 74 69 63 20 69 6e 74 20 61 73  .}.static int as
6640: 79 6e 63 52 61 6e 64 6f 6d 6e 65 73 73 28 73 71  yncRandomness(sq
6650: 6c 69 74 65 33 5f 76 66 73 20 2a 70 41 73 79 6e  lite3_vfs *pAsyn
6660: 63 56 66 73 2c 20 69 6e 74 20 6e 42 79 74 65 2c  cVfs, int nByte,
6670: 20 63 68 61 72 20 2a 7a 42 75 66 4f 75 74 29 7b   char *zBufOut){
6680: 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a  .  sqlite3_vfs *
6690: 70 56 66 73 20 3d 20 28 73 71 6c 69 74 65 33 5f  pVfs = (sqlite3_
66a0: 76 66 73 20 2a 29 70 41 73 79 6e 63 56 66 73 2d  vfs *)pAsyncVfs-
66b0: 3e 70 41 70 70 44 61 74 61 3b 0a 20 20 72 65 74  >pAppData;.  ret
66c0: 75 72 6e 20 70 56 66 73 2d 3e 78 52 61 6e 64 6f  urn pVfs->xRando
66d0: 6d 6e 65 73 73 28 70 56 66 73 2c 20 6e 42 79 74  mness(pVfs, nByt
66e0: 65 2c 20 7a 42 75 66 4f 75 74 29 3b 0a 7d 0a 73  e, zBufOut);.}.s
66f0: 74 61 74 69 63 20 69 6e 74 20 61 73 79 6e 63 53  tatic int asyncS
6700: 6c 65 65 70 28 73 71 6c 69 74 65 33 5f 76 66 73  leep(sqlite3_vfs
6710: 20 2a 70 41 73 79 6e 63 56 66 73 2c 20 69 6e 74   *pAsyncVfs, int
6720: 20 6e 4d 69 63 72 6f 29 7b 0a 20 20 73 71 6c 69   nMicro){.  sqli
6730: 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20  te3_vfs *pVfs = 
6740: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 29 70  (sqlite3_vfs *)p
6750: 41 73 79 6e 63 56 66 73 2d 3e 70 41 70 70 44 61  AsyncVfs->pAppDa
6760: 74 61 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 66  ta;.  return pVf
6770: 73 2d 3e 78 53 6c 65 65 70 28 70 56 66 73 2c 20  s->xSleep(pVfs, 
6780: 6e 4d 69 63 72 6f 29 3b 0a 7d 0a 73 74 61 74 69  nMicro);.}.stati
6790: 63 20 69 6e 74 20 61 73 79 6e 63 43 75 72 72 65  c int asyncCurre
67a0: 6e 74 54 69 6d 65 28 73 71 6c 69 74 65 33 5f 76  ntTime(sqlite3_v
67b0: 66 73 20 2a 70 41 73 79 6e 63 56 66 73 2c 20 64  fs *pAsyncVfs, d
67c0: 6f 75 62 6c 65 20 2a 70 54 69 6d 65 4f 75 74 29  ouble *pTimeOut)
67d0: 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20  {.  sqlite3_vfs 
67e0: 2a 70 56 66 73 20 3d 20 28 73 71 6c 69 74 65 33  *pVfs = (sqlite3
67f0: 5f 76 66 73 20 2a 29 70 41 73 79 6e 63 56 66 73  _vfs *)pAsyncVfs
6800: 2d 3e 70 41 70 70 44 61 74 61 3b 0a 20 20 72 65  ->pAppData;.  re
6810: 74 75 72 6e 20 70 56 66 73 2d 3e 78 43 75 72 72  turn pVfs->xCurr
6820: 65 6e 74 54 69 6d 65 28 70 56 66 73 2c 20 70 54  entTime(pVfs, pT
6830: 69 6d 65 4f 75 74 29 3b 0a 7d 0a 0a 73 74 61 74  imeOut);.}..stat
6840: 69 63 20 73 71 6c 69 74 65 33 5f 76 66 73 20 61  ic sqlite3_vfs a
6850: 73 79 6e 63 5f 76 66 73 20 3d 20 7b 0a 20 20 31  sync_vfs = {.  1
6860: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
6870: 20 20 20 20 20 2f 2a 20 69 56 65 72 73 69 6f 6e       /* iVersion
6880: 20 2a 2f 0a 20 20 73 69 7a 65 6f 66 28 41 73 79   */.  sizeof(Asy
6890: 6e 63 46 69 6c 65 29 2c 20 20 20 20 2f 2a 20 73  ncFile),    /* s
68a0: 7a 4f 73 46 69 6c 65 20 2a 2f 0a 20 20 30 2c 20  zOsFile */.  0, 
68b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
68c0: 20 20 20 2f 2a 20 6d 78 50 61 74 68 6e 61 6d 65     /* mxPathname
68d0: 20 2a 2f 0a 20 20 30 2c 20 20 20 20 20 20 20 20   */.  0,        
68e0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 70              /* p
68f0: 4e 65 78 74 20 2a 2f 0a 20 20 22 61 73 79 6e 63  Next */.  "async
6900: 22 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ",              
6910: 2f 2a 20 7a 4e 61 6d 65 20 2a 2f 0a 20 20 30 2c  /* zName */.  0,
6920: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6930: 20 20 20 20 2f 2a 20 70 41 70 70 44 61 74 61 20      /* pAppData 
6940: 2a 2f 0a 20 20 61 73 79 6e 63 4f 70 65 6e 2c 20  */.  asyncOpen, 
6950: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 4f             /* xO
6960: 70 65 6e 20 2a 2f 0a 20 20 61 73 79 6e 63 44 65  pen */.  asyncDe
6970: 6c 65 74 65 2c 20 20 20 20 20 20 20 20 20 20 2f  lete,          /
6980: 2a 20 78 44 65 6c 65 74 65 20 2a 2f 0a 20 20 61  * xDelete */.  a
6990: 73 79 6e 63 41 63 63 65 73 73 2c 20 20 20 20 20  syncAccess,     
69a0: 20 20 20 20 20 2f 2a 20 78 41 63 63 65 73 73 20       /* xAccess 
69b0: 2a 2f 0a 20 20 61 73 79 6e 63 47 65 74 54 65 6d  */.  asyncGetTem
69c0: 70 4e 61 6d 65 2c 20 20 20 20 20 2f 2a 20 78 47  pName,     /* xG
69d0: 65 74 54 65 6d 70 4e 61 6d 65 20 2a 2f 0a 20 20  etTempName */.  
69e0: 61 73 79 6e 63 46 75 6c 6c 50 61 74 68 6e 61 6d  asyncFullPathnam
69f0: 65 2c 20 20 20 20 2f 2a 20 78 46 75 6c 6c 50 61  e,    /* xFullPa
6a00: 74 68 6e 61 6d 65 20 2a 2f 0a 20 20 61 73 79 6e  thname */.  asyn
6a10: 63 44 6c 4f 70 65 6e 2c 20 20 20 20 20 20 20 20  cDlOpen,        
6a20: 20 20 2f 2a 20 78 44 6c 4f 70 65 6e 20 2a 2f 0a    /* xDlOpen */.
6a30: 20 20 61 73 79 6e 63 44 6c 45 72 72 6f 72 2c 20    asyncDlError, 
6a40: 20 20 20 20 20 20 20 20 2f 2a 20 78 44 6c 45 72          /* xDlEr
6a50: 72 6f 72 20 2a 2f 0a 20 20 61 73 79 6e 63 44 6c  ror */.  asyncDl
6a60: 53 79 6d 2c 20 20 20 20 20 20 20 20 20 20 20 2f  Sym,           /
6a70: 2a 20 78 44 6c 53 79 6d 20 2a 2f 0a 20 20 61 73  * xDlSym */.  as
6a80: 79 6e 63 44 6c 43 6c 6f 73 65 2c 20 20 20 20 20  yncDlClose,     
6a90: 20 20 20 20 2f 2a 20 78 44 6c 43 6c 6f 73 65 20      /* xDlClose 
6aa0: 2a 2f 0a 20 20 61 73 79 6e 63 52 61 6e 64 6f 6d  */.  asyncRandom
6ab0: 6e 65 73 73 2c 20 20 20 20 20 20 2f 2a 20 78 44  ness,      /* xD
6ac0: 6c 45 72 72 6f 72 20 2a 2f 0a 20 20 61 73 79 6e  lError */.  asyn
6ad0: 63 53 6c 65 65 70 2c 20 20 20 20 20 20 20 20 20  cSleep,         
6ae0: 20 20 2f 2a 20 78 44 6c 53 79 6d 20 2a 2f 0a 20    /* xDlSym */. 
6af0: 20 61 73 79 6e 63 43 75 72 72 65 6e 74 54 69 6d   asyncCurrentTim
6b00: 65 20 20 20 20 20 20 2f 2a 20 78 44 6c 43 6c 6f  e      /* xDlClo
6b10: 73 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20  se */.};../*.** 
6b20: 43 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 6e  Call this routin
6b30: 65 20 74 6f 20 65 6e 61 62 6c 65 20 6f 72 20 64  e to enable or d
6b40: 69 73 61 62 6c 65 20 74 68 65 0a 2a 2a 20 61 73  isable the.** as
6b50: 79 6e 63 68 72 6f 6e 6f 75 73 20 49 4f 20 66 65  ynchronous IO fe
6b60: 61 74 75 72 65 73 20 69 6d 70 6c 65 6d 65 6e 74  atures implement
6b70: 65 64 20 69 6e 20 74 68 69 73 20 66 69 6c 65 2e  ed in this file.
6b80: 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75   .**.** This rou
6b90: 74 69 6e 65 20 69 73 20 6e 6f 74 20 65 76 65 6e  tine is not even
6ba0: 20 72 65 6d 6f 74 65 6c 79 20 74 68 72 65 61 64   remotely thread
6bb0: 73 61 66 65 2e 20 20 44 6f 20 6e 6f 74 20 63 61  safe.  Do not ca
6bc0: 6c 6c 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 69  ll.** this routi
6bd0: 6e 65 20 77 68 69 6c 65 20 61 6e 79 20 53 51 4c  ne while any SQL
6be0: 69 74 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e  ite database con
6bf0: 6e 65 63 74 69 6f 6e 73 20 61 72 65 20 6f 70 65  nections are ope
6c00: 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  n..*/.static voi
6c10: 64 20 61 73 79 6e 63 45 6e 61 62 6c 65 28 69 6e  d asyncEnable(in
6c20: 74 20 65 6e 61 62 6c 65 29 7b 0a 20 20 69 66 28  t enable){.  if(
6c30: 20 65 6e 61 62 6c 65 20 29 7b 0a 20 20 20 20 69   enable ){.    i
6c40: 66 28 20 21 61 73 79 6e 63 5f 76 66 73 2e 70 41  f( !async_vfs.pA
6c50: 70 70 44 61 74 61 20 29 7b 0a 20 20 20 20 20 20  ppData ){.      
6c60: 61 73 79 6e 63 5f 76 66 73 2e 70 41 70 70 44 61  async_vfs.pAppDa
6c70: 74 61 20 3d 20 28 76 6f 69 64 20 2a 29 73 71 6c  ta = (void *)sql
6c80: 69 74 65 33 5f 76 66 73 5f 66 69 6e 64 28 30 29  ite3_vfs_find(0)
6c90: 3b 0a 20 20 20 20 20 20 61 73 79 6e 63 5f 76 66  ;.      async_vf
6ca0: 73 2e 6d 78 50 61 74 68 6e 61 6d 65 20 3d 20 28  s.mxPathname = (
6cb0: 28 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 29 61  (sqlite3_vfs *)a
6cc0: 73 79 6e 63 5f 76 66 73 2e 70 41 70 70 44 61 74  sync_vfs.pAppDat
6cd0: 61 29 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 3b 0a  a)->mxPathname;.
6ce0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 76 66        sqlite3_vf
6cf0: 73 5f 72 65 67 69 73 74 65 72 28 26 61 73 79 6e  s_register(&asyn
6d00: 63 5f 76 66 73 2c 20 31 29 3b 0a 20 20 20 20 20  c_vfs, 1);.     
6d10: 20 73 71 6c 69 74 65 33 48 61 73 68 49 6e 69 74   sqlite3HashInit
6d20: 28 26 61 73 79 6e 63 2e 61 4c 6f 63 6b 2c 20 53  (&async.aLock, S
6d30: 51 4c 49 54 45 5f 48 41 53 48 5f 42 49 4e 41 52  QLITE_HASH_BINAR
6d40: 59 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  Y, 1);.    }.  }
6d50: 65 6c 73 65 7b 0a 20 20 20 20 69 66 28 20 61 73  else{.    if( as
6d60: 79 6e 63 5f 76 66 73 2e 70 41 70 70 44 61 74 61  ync_vfs.pAppData
6d70: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
6d80: 33 5f 76 66 73 5f 75 6e 72 65 67 69 73 74 65 72  3_vfs_unregister
6d90: 28 26 61 73 79 6e 63 5f 76 66 73 29 3b 0a 20 20  (&async_vfs);.  
6da0: 20 20 20 20 61 73 79 6e 63 5f 76 66 73 2e 70 41      async_vfs.pA
6db0: 70 70 44 61 74 61 20 3d 20 30 3b 0a 20 20 20 20  ppData = 0;.    
6dc0: 20 20 73 71 6c 69 74 65 33 48 61 73 68 43 6c 65    sqlite3HashCle
6dd0: 61 72 28 26 61 73 79 6e 63 2e 61 4c 6f 63 6b 29  ar(&async.aLock)
6de0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f  ;.    }.  }.}../
6df0: 2a 20 0a 2a 2a 20 54 68 69 73 20 70 72 6f 63 65  * .** This proce
6e00: 64 75 72 65 20 72 75 6e 73 20 69 6e 20 61 20 73  dure runs in a s
6e10: 65 70 61 72 61 74 65 20 74 68 72 65 61 64 2c 20  eparate thread, 
6e20: 72 65 61 64 69 6e 67 20 6d 65 73 73 61 67 65 73  reading messages
6e30: 20 6f 66 66 20 6f 66 20 74 68 65 0a 2a 2a 20 77   off of the.** w
6e40: 72 69 74 65 20 71 75 65 75 65 20 61 6e 64 20 70  rite queue and p
6e50: 72 6f 63 65 73 73 69 6e 67 20 74 68 65 6d 20 6f  rocessing them o
6e60: 6e 65 20 62 79 20 6f 6e 65 2e 20 20 0a 2a 2a 0a  ne by one.  .**.
6e70: 2a 2a 20 49 66 20 61 73 79 6e 63 2e 77 72 69 74  ** If async.writ
6e80: 65 72 48 61 6c 74 4e 6f 77 20 69 73 20 74 72 75  erHaltNow is tru
6e90: 65 2c 20 74 68 65 6e 20 74 68 69 73 20 70 72 6f  e, then this pro
6ea0: 63 65 64 75 72 65 20 65 78 69 74 73 0a 2a 2a 20  cedure exits.** 
6eb0: 61 66 74 65 72 20 70 72 6f 63 65 73 73 69 6e 67  after processing
6ec0: 20 61 20 73 69 6e 67 6c 65 20 6d 65 73 73 61 67   a single messag
6ed0: 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 73 79 6e  e..**.** If asyn
6ee0: 63 2e 77 72 69 74 65 72 48 61 6c 74 57 68 65 6e  c.writerHaltWhen
6ef0: 49 64 6c 65 20 69 73 20 74 72 75 65 2c 20 74 68  Idle is true, th
6f00: 65 6e 20 74 68 69 73 20 70 72 6f 63 65 64 75 72  en this procedur
6f10: 65 20 65 78 69 74 73 20 77 68 65 6e 0a 2a 2a 20  e exits when.** 
6f20: 74 68 65 20 77 72 69 74 65 20 71 75 65 75 65 20  the write queue 
6f30: 69 73 20 65 6d 70 74 79 2e 0a 2a 2a 0a 2a 2a 20  is empty..**.** 
6f40: 49 66 20 62 6f 74 68 20 6f 66 20 74 68 65 20 61  If both of the a
6f50: 62 6f 76 65 20 76 61 72 69 61 62 6c 65 73 20 61  bove variables a
6f60: 72 65 20 66 61 6c 73 65 2c 20 74 68 69 73 20 70  re false, this p
6f70: 72 6f 63 65 64 75 72 65 20 72 75 6e 73 0a 2a 2a  rocedure runs.**
6f80: 20 69 6e 64 65 66 69 6e 61 74 65 6c 79 2c 20 77   indefinately, w
6f90: 61 69 74 69 6e 67 20 66 6f 72 20 6f 70 65 72 61  aiting for opera
6fa0: 74 69 6f 6e 73 20 74 6f 20 62 65 20 61 64 64 65  tions to be adde
6fb0: 64 20 74 6f 20 74 68 65 20 77 72 69 74 65 20 71  d to the write q
6fc0: 75 65 75 65 0a 2a 2a 20 61 6e 64 20 70 72 6f 63  ueue.** and proc
6fd0: 65 73 73 69 6e 67 20 74 68 65 6d 20 69 6e 20 74  essing them in t
6fe0: 68 65 20 6f 72 64 65 72 20 69 6e 20 77 68 69 63  he order in whic
6ff0: 68 20 74 68 65 79 20 61 72 72 69 76 65 2e 0a 2a  h they arrive..*
7000: 2a 0a 2a 2a 20 41 6e 20 61 72 74 69 66 69 63 61  *.** An artifica
7010: 6c 20 64 65 6c 61 79 20 6f 66 20 61 73 79 6e 63  l delay of async
7020: 2e 69 6f 44 65 6c 61 79 20 6d 69 6c 6c 69 73 65  .ioDelay millise
7030: 63 6f 6e 64 73 20 69 73 20 69 6e 73 65 72 74 65  conds is inserte
7040: 64 20 62 65 66 6f 72 65 0a 2a 2a 20 65 61 63 68  d before.** each
7050: 20 77 72 69 74 65 20 6f 70 65 72 61 74 69 6f 6e   write operation
7060: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 73 69 6d   in order to sim
7070: 75 6c 61 74 65 20 74 68 65 20 65 66 66 65 63 74  ulate the effect
7080: 20 6f 66 20 61 20 73 6c 6f 77 20 64 69 73 6b 2e   of a slow disk.
7090: 0a 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 6f 6e 65 20  .**.** Only one 
70a0: 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73  instance of this
70b0: 20 70 72 6f 63 65 64 75 72 65 20 6d 61 79 20 62   procedure may b
70c0: 65 20 72 75 6e 6e 69 6e 67 20 61 74 20 61 20 74  e running at a t
70d0: 69 6d 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ime..*/.static v
70e0: 6f 69 64 20 2a 61 73 79 6e 63 57 72 69 74 65 72  oid *asyncWriter
70f0: 54 68 72 65 61 64 28 76 6f 69 64 20 2a 4e 6f 74  Thread(void *Not
7100: 55 73 65 64 29 7b 0a 20 20 73 71 6c 69 74 65 33  Used){.  sqlite3
7110: 5f 76 66 73 20 2a 70 56 66 73 20 3d 20 28 73 71  _vfs *pVfs = (sq
7120: 6c 69 74 65 33 5f 76 66 73 20 2a 29 28 61 73 79  lite3_vfs *)(asy
7130: 6e 63 5f 76 66 73 2e 70 41 70 70 44 61 74 61 29  nc_vfs.pAppData)
7140: 3b 0a 20 20 41 73 79 6e 63 57 72 69 74 65 20 2a  ;.  AsyncWrite *
7150: 70 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 20  p = 0;.  int rc 
7160: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69  = SQLITE_OK;.  i
7170: 6e 74 20 68 6f 6c 64 69 6e 67 4d 75 74 65 78 20  nt holdingMutex 
7180: 3d 20 30 3b 0a 0a 20 20 69 66 28 20 70 74 68 72  = 0;..  if( pthr
7190: 65 61 64 5f 6d 75 74 65 78 5f 74 72 79 6c 6f 63  ead_mutex_tryloc
71a0: 6b 28 26 61 73 79 6e 63 2e 77 72 69 74 65 72 4d  k(&async.writerM
71b0: 75 74 65 78 29 20 29 7b 0a 20 20 20 20 72 65 74  utex) ){.    ret
71c0: 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 77 68 69  urn 0;.  }.  whi
71d0: 6c 65 28 20 61 73 79 6e 63 2e 77 72 69 74 65 72  le( async.writer
71e0: 48 61 6c 74 4e 6f 77 3d 3d 30 20 29 7b 0a 20 20  HaltNow==0 ){.  
71f0: 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a    sqlite3_file *
7200: 70 42 61 73 65 20 3d 20 30 3b 0a 0a 20 20 20 20  pBase = 0;..    
7210: 69 66 28 20 21 68 6f 6c 64 69 6e 67 4d 75 74 65  if( !holdingMute
7220: 78 20 29 7b 0a 20 20 20 20 20 20 70 74 68 72 65  x ){.      pthre
7230: 61 64 5f 6d 75 74 65 78 5f 6c 6f 63 6b 28 26 61  ad_mutex_lock(&a
7240: 73 79 6e 63 2e 71 75 65 75 65 4d 75 74 65 78 29  sync.queueMutex)
7250: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 77 68 69 6c  ;.    }.    whil
7260: 65 28 20 28 70 20 3d 20 61 73 79 6e 63 2e 70 51  e( (p = async.pQ
7270: 75 65 75 65 46 69 72 73 74 29 3d 3d 30 20 29 7b  ueueFirst)==0 ){
7280: 0a 20 20 20 20 20 20 70 74 68 72 65 61 64 5f 63  .      pthread_c
7290: 6f 6e 64 5f 62 72 6f 61 64 63 61 73 74 28 26 61  ond_broadcast(&a
72a0: 73 79 6e 63 2e 65 6d 70 74 79 53 69 67 6e 61 6c  sync.emptySignal
72b0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 61 73 79  );.      if( asy
72c0: 6e 63 2e 77 72 69 74 65 72 48 61 6c 74 57 68 65  nc.writerHaltWhe
72d0: 6e 49 64 6c 65 20 29 7b 0a 20 20 20 20 20 20 20  nIdle ){.       
72e0: 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 75   pthread_mutex_u
72f0: 6e 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 71 75 65  nlock(&async.que
7300: 75 65 4d 75 74 65 78 29 3b 0a 20 20 20 20 20 20  ueMutex);.      
7310: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d    break;.      }
7320: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 41 53  else{.        AS
7330: 59 4e 43 5f 54 52 41 43 45 28 28 22 49 44 4c 45  YNC_TRACE(("IDLE
7340: 5c 6e 22 29 29 3b 0a 20 20 20 20 20 20 20 20 70  \n"));.        p
7350: 74 68 72 65 61 64 5f 63 6f 6e 64 5f 77 61 69 74  thread_cond_wait
7360: 28 26 61 73 79 6e 63 2e 71 75 65 75 65 53 69 67  (&async.queueSig
7370: 6e 61 6c 2c 20 26 61 73 79 6e 63 2e 71 75 65 75  nal, &async.queu
7380: 65 4d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 20  eMutex);.       
7390: 20 41 53 59 4e 43 5f 54 52 41 43 45 28 28 22 57   ASYNC_TRACE(("W
73a0: 41 4b 45 55 50 5c 6e 22 29 29 3b 0a 20 20 20 20  AKEUP\n"));.    
73b0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66    }.    }.    if
73c0: 28 20 70 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a  ( p==0 ) break;.
73d0: 20 20 20 20 68 6f 6c 64 69 6e 67 4d 75 74 65 78      holdingMutex
73e0: 20 3d 20 31 3b 0a 0a 20 20 20 20 2f 2a 20 52 69   = 1;..    /* Ri
73f0: 67 68 74 20 6e 6f 77 20 74 68 69 73 20 74 68 72  ght now this thr
7400: 65 61 64 20 69 73 20 68 6f 6c 64 69 6e 67 20 74  ead is holding t
7410: 68 65 20 6d 75 74 65 78 20 6f 6e 20 74 68 65 20  he mutex on the 
7420: 77 72 69 74 65 2d 6f 70 20 71 75 65 75 65 2e 0a  write-op queue..
7430: 20 20 20 20 2a 2a 20 56 61 72 69 61 62 6c 65 20      ** Variable 
7440: 27 70 27 20 70 6f 69 6e 74 73 20 74 6f 20 74 68  'p' points to th
7450: 65 20 66 69 72 73 74 20 65 6e 74 72 79 20 69 6e  e first entry in
7460: 20 74 68 65 20 77 72 69 74 65 2d 6f 70 20 71 75   the write-op qu
7470: 65 75 65 2e 20 49 6e 0a 20 20 20 20 2a 2a 20 74  eue. In.    ** t
7480: 68 65 20 67 65 6e 65 72 61 6c 20 63 61 73 65 2c  he general case,
7490: 20 77 65 20 68 6f 6c 64 20 6f 6e 20 74 6f 20 74   we hold on to t
74a0: 68 65 20 6d 75 74 65 78 20 66 6f 72 20 74 68 65  he mutex for the
74b0: 20 65 6e 74 69 72 65 20 62 6f 64 79 20 6f 66 0a   entire body of.
74c0: 20 20 20 20 2a 2a 20 74 68 65 20 6c 6f 6f 70 2e      ** the loop.
74d0: 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20   .    **.    ** 
74e0: 48 6f 77 65 76 65 72 20 69 6e 20 74 68 65 20 63  However in the c
74f0: 61 73 65 73 20 65 6e 75 6d 65 72 61 74 65 64 20  ases enumerated 
7500: 62 65 6c 6f 77 2c 20 77 65 20 72 65 6c 69 6e 71  below, we relinq
7510: 75 69 73 68 20 74 68 65 20 6d 75 74 65 78 2c 0a  uish the mutex,.
7520: 20 20 20 20 2a 2a 20 70 65 72 66 6f 72 6d 20 74      ** perform t
7530: 68 65 20 49 4f 2c 20 61 6e 64 20 74 68 65 6e 20  he IO, and then 
7540: 72 65 2d 72 65 71 75 65 73 74 20 74 68 65 20 6d  re-request the m
7550: 75 74 65 78 20 62 65 66 6f 72 65 20 72 65 6d 6f  utex before remo
7560: 76 69 6e 67 20 27 70 27 20 66 72 6f 6d 0a 20 20  ving 'p' from.  
7570: 20 20 2a 2a 20 74 68 65 20 68 65 61 64 20 6f 66    ** the head of
7580: 20 74 68 65 20 77 72 69 74 65 2d 6f 70 20 71 75   the write-op qu
7590: 65 75 65 2e 20 54 68 65 20 69 64 65 61 20 69 73  eue. The idea is
75a0: 20 74 6f 20 69 6e 63 72 65 61 73 65 20 63 6f 6e   to increase con
75b0: 63 75 72 72 65 6e 63 79 20 77 69 74 68 0a 20 20  currency with.  
75c0: 20 20 2a 2a 20 73 71 6c 69 74 65 20 74 68 72 65    ** sqlite thre
75d0: 61 64 73 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20  ads..    **.    
75e0: 2a 2a 20 20 20 20 20 2a 20 41 6e 20 41 53 59 4e  **     * An ASYN
75f0: 43 5f 43 4c 4f 53 45 20 6f 70 65 72 61 74 69 6f  C_CLOSE operatio
7600: 6e 2e 0a 20 20 20 20 2a 2a 20 20 20 20 20 2a 20  n..    **     * 
7610: 41 6e 20 41 53 59 4e 43 5f 4f 50 45 4e 45 58 43  An ASYNC_OPENEXC
7620: 4c 55 53 49 56 45 20 6f 70 65 72 61 74 69 6f 6e  LUSIVE operation
7630: 2e 20 46 6f 72 20 74 68 69 73 20 6f 6e 65 2c 20  . For this one, 
7640: 77 65 20 72 65 6c 69 6e 71 75 69 73 68 20 0a 20  we relinquish . 
7650: 20 20 20 2a 2a 20 20 20 20 20 20 20 74 68 65 20     **       the 
7660: 6d 75 74 65 78 2c 20 63 61 6c 6c 20 74 68 65 20  mutex, call the 
7670: 75 6e 64 65 72 6c 79 69 6e 67 20 78 4f 70 65 6e  underlying xOpen
7680: 45 78 63 6c 75 73 69 76 65 28 29 20 66 75 6e 63  Exclusive() func
7690: 74 69 6f 6e 2c 20 74 68 65 6e 0a 20 20 20 20 2a  tion, then.    *
76a0: 2a 20 20 20 20 20 20 20 72 65 2d 61 71 75 69 72  *       re-aquir
76b0: 65 20 74 68 65 20 6d 75 74 65 78 20 62 65 66 6f  e the mutex befo
76c0: 72 65 20 73 65 74 69 6e 67 20 74 68 65 20 41 73  re seting the As
76d0: 79 6e 63 46 69 6c 65 2e 70 42 61 73 65 52 65 61  yncFile.pBaseRea
76e0: 64 20 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 20  d .    **       
76f0: 76 61 72 69 61 62 6c 65 2e 0a 20 20 20 20 2a 2a  variable..    **
7700: 20 20 20 20 20 2a 20 41 53 59 4e 43 5f 53 59 4e       * ASYNC_SYN
7710: 43 20 61 6e 64 20 41 53 59 4e 43 5f 57 52 49 54  C and ASYNC_WRIT
7720: 45 20 6f 70 65 72 61 74 69 6f 6e 73 2c 20 69 66  E operations, if
7730: 20 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 20 53   .    **       S
7740: 51 4c 49 54 45 5f 41 53 59 4e 43 5f 54 57 4f 5f  QLITE_ASYNC_TWO_
7750: 46 49 4c 45 48 41 4e 44 4c 45 53 20 77 61 73 20  FILEHANDLES was 
7760: 73 65 74 20 61 74 20 63 6f 6d 70 69 6c 65 20 74  set at compile t
7770: 69 6d 65 20 61 6e 64 20 74 77 6f 0a 20 20 20 20  ime and two.    
7780: 2a 2a 20 20 20 20 20 20 20 66 69 6c 65 2d 68 61  **       file-ha
7790: 6e 64 6c 65 73 20 61 72 65 20 6f 70 65 6e 20 66  ndles are open f
77a0: 6f 72 20 74 68 65 20 70 61 72 74 69 63 75 6c 61  or the particula
77b0: 72 20 66 69 6c 65 20 62 65 69 6e 67 20 22 73 79  r file being "sy
77c0: 6e 63 65 64 22 2e 0a 20 20 20 20 2a 2f 0a 20 20  nced"..    */.  
77d0: 20 20 69 66 28 20 61 73 79 6e 63 2e 69 6f 45 72    if( async.ioEr
77e0: 72 6f 72 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26  ror!=SQLITE_OK &
77f0: 26 20 70 2d 3e 6f 70 21 3d 41 53 59 4e 43 5f 43  & p->op!=ASYNC_C
7800: 4c 4f 53 45 20 29 7b 0a 20 20 20 20 20 20 70 2d  LOSE ){.      p-
7810: 3e 6f 70 20 3d 20 41 53 59 4e 43 5f 4e 4f 4f 50  >op = ASYNC_NOOP
7820: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20  ;.    }.    if( 
7830: 70 2d 3e 70 46 69 6c 65 44 61 74 61 20 29 7b 0a  p->pFileData ){.
7840: 20 20 20 20 20 20 70 42 61 73 65 20 3d 20 70 2d        pBase = p-
7850: 3e 70 46 69 6c 65 44 61 74 61 2d 3e 70 42 61 73  >pFileData->pBas
7860: 65 57 72 69 74 65 3b 0a 20 20 20 20 20 20 69 66  eWrite;.      if
7870: 28 20 0a 20 20 20 20 20 20 20 20 70 2d 3e 6f 70  ( .        p->op
7880: 3d 3d 41 53 59 4e 43 5f 43 4c 4f 53 45 20 7c 7c  ==ASYNC_CLOSE ||
7890: 20 0a 20 20 20 20 20 20 20 20 70 2d 3e 6f 70 3d   .        p->op=
78a0: 3d 41 53 59 4e 43 5f 4f 50 45 4e 45 58 43 4c 55  =ASYNC_OPENEXCLU
78b0: 53 49 56 45 20 7c 7c 0a 20 20 20 20 20 20 20 20  SIVE ||.        
78c0: 28 70 42 61 73 65 2d 3e 70 4d 65 74 68 6f 64 73  (pBase->pMethods
78d0: 20 26 26 20 28 70 2d 3e 6f 70 3d 3d 41 53 59 4e   && (p->op==ASYN
78e0: 43 5f 53 59 4e 43 20 7c 7c 20 70 2d 3e 6f 70 3d  C_SYNC || p->op=
78f0: 3d 41 53 59 4e 43 5f 57 52 49 54 45 29 20 29 20  =ASYNC_WRITE) ) 
7900: 0a 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20  .      ){.      
7910: 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f    pthread_mutex_
7920: 75 6e 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 71 75  unlock(&async.qu
7930: 65 75 65 4d 75 74 65 78 29 3b 0a 20 20 20 20 20  eueMutex);.     
7940: 20 20 20 68 6f 6c 64 69 6e 67 4d 75 74 65 78 20     holdingMutex 
7950: 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  = 0;.      }.   
7960: 20 20 20 69 66 28 20 21 70 42 61 73 65 2d 3e 70     if( !pBase->p
7970: 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 20 20 20  Methods ){.     
7980: 20 20 20 70 42 61 73 65 20 3d 20 70 2d 3e 70 46     pBase = p->pF
7990: 69 6c 65 44 61 74 61 2d 3e 70 42 61 73 65 52 65  ileData->pBaseRe
79a0: 61 64 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ad;.      }.    
79b0: 7d 0a 0a 20 20 20 20 73 77 69 74 63 68 28 20 70  }..    switch( p
79c0: 2d 3e 6f 70 20 29 7b 0a 20 20 20 20 20 20 63 61  ->op ){.      ca
79d0: 73 65 20 41 53 59 4e 43 5f 4e 4f 4f 50 3a 0a 20  se ASYNC_NOOP:. 
79e0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 0a 20         break;.. 
79f0: 20 20 20 20 20 63 61 73 65 20 41 53 59 4e 43 5f       case ASYNC_
7a00: 57 52 49 54 45 3a 0a 20 20 20 20 20 20 20 20 61  WRITE:.        a
7a10: 73 73 65 72 74 28 20 70 42 61 73 65 20 29 3b 0a  ssert( pBase );.
7a20: 20 20 20 20 20 20 20 20 41 53 59 4e 43 5f 54 52          ASYNC_TR
7a30: 41 43 45 28 28 22 57 52 49 54 45 20 25 73 20 25  ACE(("WRITE %s %
7a40: 64 20 62 79 74 65 73 20 61 74 20 25 64 5c 6e 22  d bytes at %d\n"
7a50: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,.              
7a60: 20 20 70 2d 3e 70 46 69 6c 65 44 61 74 61 2d 3e    p->pFileData->
7a70: 7a 4e 61 6d 65 2c 20 70 2d 3e 6e 42 79 74 65 2c  zName, p->nByte,
7a80: 20 70 2d 3e 69 4f 66 66 73 65 74 29 29 3b 0a 20   p->iOffset));. 
7a90: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69         rc = sqli
7aa0: 74 65 33 4f 73 57 72 69 74 65 28 70 42 61 73 65  te3OsWrite(pBase
7ab0: 2c 20 28 76 6f 69 64 20 2a 29 28 70 2d 3e 7a 42  , (void *)(p->zB
7ac0: 75 66 29 2c 20 70 2d 3e 6e 42 79 74 65 2c 20 70  uf), p->nByte, p
7ad0: 2d 3e 69 4f 66 66 73 65 74 29 3b 0a 20 20 20 20  ->iOffset);.    
7ae0: 20 20 20 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20      break;..    
7af0: 20 20 63 61 73 65 20 41 53 59 4e 43 5f 53 59 4e    case ASYNC_SYN
7b00: 43 3a 0a 20 20 20 20 20 20 20 20 61 73 73 65 72  C:.        asser
7b10: 74 28 20 70 42 61 73 65 20 29 3b 0a 20 20 20 20  t( pBase );.    
7b20: 20 20 20 20 41 53 59 4e 43 5f 54 52 41 43 45 28      ASYNC_TRACE(
7b30: 28 22 53 59 4e 43 20 25 73 5c 6e 22 2c 20 70 2d  ("SYNC %s\n", p-
7b40: 3e 70 46 69 6c 65 44 61 74 61 2d 3e 7a 4e 61 6d  >pFileData->zNam
7b50: 65 29 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20  e));.        rc 
7b60: 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28  = sqlite3OsSync(
7b70: 70 42 61 73 65 2c 20 70 2d 3e 6e 42 79 74 65 29  pBase, p->nByte)
7b80: 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  ;.        break;
7b90: 0a 0a 20 20 20 20 20 20 63 61 73 65 20 41 53 59  ..      case ASY
7ba0: 4e 43 5f 54 52 55 4e 43 41 54 45 3a 0a 20 20 20  NC_TRUNCATE:.   
7bb0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 42 61       assert( pBa
7bc0: 73 65 20 29 3b 0a 20 20 20 20 20 20 20 20 41 53  se );.        AS
7bd0: 59 4e 43 5f 54 52 41 43 45 28 28 22 54 52 55 4e  YNC_TRACE(("TRUN
7be0: 43 41 54 45 20 25 73 20 74 6f 20 25 64 20 62 79  CATE %s to %d by
7bf0: 74 65 73 5c 6e 22 2c 20 0a 20 20 20 20 20 20 20  tes\n", .       
7c00: 20 20 20 20 20 20 20 20 20 70 2d 3e 70 46 69 6c           p->pFil
7c10: 65 44 61 74 61 2d 3e 7a 4e 61 6d 65 2c 20 70 2d  eData->zName, p-
7c20: 3e 69 4f 66 66 73 65 74 29 29 3b 0a 20 20 20 20  >iOffset));.    
7c30: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
7c40: 4f 73 54 72 75 6e 63 61 74 65 28 70 42 61 73 65  OsTruncate(pBase
7c50: 2c 20 70 2d 3e 69 4f 66 66 73 65 74 29 3b 0a 20  , p->iOffset);. 
7c60: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 0a 20         break;.. 
7c70: 20 20 20 20 20 63 61 73 65 20 41 53 59 4e 43 5f       case ASYNC_
7c80: 43 4c 4f 53 45 3a 0a 20 20 20 20 20 20 20 20 41  CLOSE:.        A
7c90: 53 59 4e 43 5f 54 52 41 43 45 28 28 22 43 4c 4f  SYNC_TRACE(("CLO
7ca0: 53 45 20 25 73 5c 6e 22 2c 20 70 2d 3e 70 46 69  SE %s\n", p->pFi
7cb0: 6c 65 44 61 74 61 2d 3e 7a 4e 61 6d 65 29 29 3b  leData->zName));
7cc0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
7cd0: 4f 73 43 6c 6f 73 65 28 70 2d 3e 70 46 69 6c 65  OsClose(p->pFile
7ce0: 44 61 74 61 2d 3e 70 42 61 73 65 57 72 69 74 65  Data->pBaseWrite
7cf0: 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  );.        sqlit
7d00: 65 33 4f 73 43 6c 6f 73 65 28 70 2d 3e 70 46 69  e3OsClose(p->pFi
7d10: 6c 65 44 61 74 61 2d 3e 70 42 61 73 65 52 65 61  leData->pBaseRea
7d20: 64 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  d);.        sqli
7d30: 74 65 33 5f 66 72 65 65 28 70 2d 3e 70 46 69 6c  te3_free(p->pFil
7d40: 65 44 61 74 61 29 3b 0a 20 20 20 20 20 20 20 20  eData);.        
7d50: 62 72 65 61 6b 3b 0a 0a 20 20 20 20 20 20 63 61  break;..      ca
7d60: 73 65 20 41 53 59 4e 43 5f 44 45 4c 45 54 45 3a  se ASYNC_DELETE:
7d70: 0a 20 20 20 20 20 20 20 20 41 53 59 4e 43 5f 54  .        ASYNC_T
7d80: 52 41 43 45 28 28 22 44 45 4c 45 54 45 20 25 73  RACE(("DELETE %s
7d90: 5c 6e 22 2c 20 70 2d 3e 7a 42 75 66 29 29 3b 0a  \n", p->zBuf));.
7da0: 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c          rc = sql
7db0: 69 74 65 33 4f 73 44 65 6c 65 74 65 28 70 56 66  ite3OsDelete(pVf
7dc0: 73 2c 20 70 2d 3e 7a 42 75 66 2c 20 28 69 6e 74  s, p->zBuf, (int
7dd0: 29 70 2d 3e 69 4f 66 66 73 65 74 29 3b 0a 20 20  )p->iOffset);.  
7de0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 0a 20 20        break;..  
7df0: 20 20 20 20 63 61 73 65 20 41 53 59 4e 43 5f 4f      case ASYNC_O
7e00: 50 45 4e 45 58 43 4c 55 53 49 56 45 3a 20 7b 0a  PENEXCLUSIVE: {.
7e10: 20 20 20 20 20 20 20 20 69 6e 74 20 66 6c 61 67          int flag
7e20: 73 20 3d 20 28 69 6e 74 29 70 2d 3e 69 4f 66 66  s = (int)p->iOff
7e30: 73 65 74 3b 0a 20 20 20 20 20 20 20 20 41 73 79  set;.        Asy
7e40: 6e 63 46 69 6c 65 44 61 74 61 20 2a 70 44 61 74  ncFileData *pDat
7e50: 61 20 3d 20 70 2d 3e 70 46 69 6c 65 44 61 74 61  a = p->pFileData
7e60: 3b 0a 20 20 20 20 20 20 20 20 41 53 59 4e 43 5f  ;.        ASYNC_
7e70: 54 52 41 43 45 28 28 22 4f 50 45 4e 20 25 73 20  TRACE(("OPEN %s 
7e80: 66 6c 61 67 73 3d 25 64 5c 6e 22 2c 20 70 2d 3e  flags=%d\n", p->
7e90: 7a 42 75 66 2c 20 28 69 6e 74 29 70 2d 3e 69 4f  zBuf, (int)p->iO
7ea0: 66 66 73 65 74 29 29 3b 0a 20 20 20 20 20 20 20  ffset));.       
7eb0: 20 61 73 73 65 72 74 28 70 44 61 74 61 2d 3e 70   assert(pData->p
7ec0: 42 61 73 65 52 65 61 64 2d 3e 70 4d 65 74 68 6f  BaseRead->pMetho
7ed0: 64 73 3d 3d 30 20 26 26 20 70 44 61 74 61 2d 3e  ds==0 && pData->
7ee0: 70 42 61 73 65 57 72 69 74 65 2d 3e 70 4d 65 74  pBaseWrite->pMet
7ef0: 68 6f 64 73 3d 3d 30 29 3b 0a 20 20 20 20 20 20  hods==0);.      
7f00: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73    rc = sqlite3Os
7f10: 4f 70 65 6e 28 70 56 66 73 2c 20 70 44 61 74 61  Open(pVfs, pData
7f20: 2d 3e 7a 4e 61 6d 65 2c 20 70 44 61 74 61 2d 3e  ->zName, pData->
7f30: 70 42 61 73 65 52 65 61 64 2c 20 66 6c 61 67 73  pBaseRead, flags
7f40: 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 61 73  , 0);.        as
7f50: 73 65 72 74 28 20 68 6f 6c 64 69 6e 67 4d 75 74  sert( holdingMut
7f60: 65 78 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20  ex==0 );.       
7f70: 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 6c   pthread_mutex_l
7f80: 6f 63 6b 28 26 61 73 79 6e 63 2e 71 75 65 75 65  ock(&async.queue
7f90: 4d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 20 20  Mutex);.        
7fa0: 68 6f 6c 64 69 6e 67 4d 75 74 65 78 20 3d 20 31  holdingMutex = 1
7fb0: 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  ;.        break;
7fc0: 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20  .      }..      
7fd0: 64 65 66 61 75 6c 74 3a 20 61 73 73 65 72 74 28  default: assert(
7fe0: 21 22 49 6c 6c 65 67 61 6c 20 76 61 6c 75 65 20  !"Illegal value 
7ff0: 66 6f 72 20 41 73 79 6e 63 57 72 69 74 65 2e 6f  for AsyncWrite.o
8000: 70 22 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20  p");.    }..    
8010: 2f 2a 20 49 66 20 77 65 20 64 69 64 6e 27 74 20  /* If we didn't 
8020: 68 61 6e 67 20 6f 6e 20 74 6f 20 74 68 65 20 6d  hang on to the m
8030: 75 74 65 78 20 64 75 72 69 6e 67 20 74 68 65 20  utex during the 
8040: 49 4f 20 6f 70 2c 20 6f 62 74 61 69 6e 20 69 74  IO op, obtain it
8050: 20 6e 6f 77 0a 20 20 20 20 2a 2a 20 73 6f 20 74   now.    ** so t
8060: 68 61 74 20 74 68 65 20 41 73 79 6e 63 57 72 69  hat the AsyncWri
8070: 74 65 20 73 74 72 75 63 74 75 72 65 20 63 61 6e  te structure can
8080: 20 62 65 20 73 61 66 65 6c 79 20 72 65 6d 6f 76   be safely remov
8090: 65 64 20 66 72 6f 6d 20 74 68 65 20 0a 20 20 20  ed from the .   
80a0: 20 2a 2a 20 67 6c 6f 62 61 6c 20 77 72 69 74 65   ** global write
80b0: 2d 6f 70 20 71 75 65 75 65 2e 0a 20 20 20 20 2a  -op queue..    *
80c0: 2f 0a 20 20 20 20 69 66 28 20 21 68 6f 6c 64 69  /.    if( !holdi
80d0: 6e 67 4d 75 74 65 78 20 29 7b 0a 20 20 20 20 20  ngMutex ){.     
80e0: 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 6c   pthread_mutex_l
80f0: 6f 63 6b 28 26 61 73 79 6e 63 2e 71 75 65 75 65  ock(&async.queue
8100: 4d 75 74 65 78 29 3b 0a 20 20 20 20 20 20 68 6f  Mutex);.      ho
8110: 6c 64 69 6e 67 4d 75 74 65 78 20 3d 20 31 3b 0a  ldingMutex = 1;.
8120: 20 20 20 20 7d 0a 20 20 20 20 2f 2a 20 41 53 59      }.    /* ASY
8130: 4e 43 5f 54 52 41 43 45 28 28 22 55 4e 4c 49 4e  NC_TRACE(("UNLIN
8140: 4b 20 25 70 5c 6e 22 2c 20 70 29 29 3b 20 2a 2f  K %p\n", p)); */
8150: 0a 20 20 20 20 69 66 28 20 70 3d 3d 61 73 79 6e  .    if( p==asyn
8160: 63 2e 70 51 75 65 75 65 4c 61 73 74 20 29 7b 0a  c.pQueueLast ){.
8170: 20 20 20 20 20 20 61 73 79 6e 63 2e 70 51 75 65        async.pQue
8180: 75 65 4c 61 73 74 20 3d 20 30 3b 0a 20 20 20 20  ueLast = 0;.    
8190: 7d 0a 20 20 20 20 61 73 79 6e 63 2e 70 51 75 65  }.    async.pQue
81a0: 75 65 46 69 72 73 74 20 3d 20 70 2d 3e 70 4e 65  ueFirst = p->pNe
81b0: 78 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  xt;.    sqlite3_
81c0: 66 72 65 65 28 70 29 3b 0a 20 20 20 20 61 73 73  free(p);.    ass
81d0: 65 72 74 28 20 68 6f 6c 64 69 6e 67 4d 75 74 65  ert( holdingMute
81e0: 78 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 41 6e 20  x );..    /* An 
81f0: 49 4f 20 65 72 72 6f 72 20 68 61 73 20 6f 63 63  IO error has occ
8200: 75 72 65 64 2e 20 57 65 20 63 61 6e 6e 6f 74 20  ured. We cannot 
8210: 72 65 70 6f 72 74 20 74 68 65 20 65 72 72 6f 72  report the error
8220: 20 62 61 63 6b 20 74 6f 20 74 68 65 0a 20 20 20   back to the.   
8230: 20 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74   ** connection t
8240: 68 61 74 20 72 65 71 75 65 73 74 65 64 20 74 68  hat requested th
8250: 65 20 49 2f 4f 20 73 69 6e 63 65 20 74 68 65 20  e I/O since the 
8260: 65 72 72 6f 72 20 68 61 70 70 65 6e 65 64 20 0a  error happened .
8270: 20 20 20 20 2a 2a 20 61 73 79 6e 63 68 72 6f 6e      ** asynchron
8280: 6f 75 73 6c 79 2e 20 20 54 68 65 20 63 6f 6e 6e  ously.  The conn
8290: 65 63 74 69 6f 6e 20 68 61 73 20 61 6c 72 65 61  ection has alrea
82a0: 64 79 20 6d 6f 76 65 64 20 6f 6e 2e 20 20 54 68  dy moved on.  Th
82b0: 65 72 65 20 0a 20 20 20 20 2a 2a 20 72 65 61 6c  ere .    ** real
82c0: 6c 79 20 69 73 20 6e 6f 62 6f 64 79 20 74 6f 20  ly is nobody to 
82d0: 72 65 70 6f 72 74 20 74 68 65 20 65 72 72 6f 72  report the error
82e0: 20 74 6f 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20   to..    **.    
82f0: 2a 2a 20 54 68 65 20 66 69 6c 65 20 66 6f 72 20  ** The file for 
8300: 77 68 69 63 68 20 74 68 65 20 65 72 72 6f 72 20  which the error 
8310: 6f 63 63 75 72 65 64 20 6d 61 79 20 68 61 76 65  occured may have
8320: 20 62 65 65 6e 20 61 20 64 61 74 61 62 61 73 65   been a database
8330: 20 6f 72 0a 20 20 20 20 2a 2a 20 6a 6f 75 72 6e   or.    ** journ
8340: 61 6c 20 66 69 6c 65 2e 20 52 65 67 61 72 64 6c  al file. Regardl
8350: 65 73 73 2c 20 6e 6f 6e 65 20 6f 66 20 74 68 65  ess, none of the
8360: 20 63 75 72 72 65 6e 74 6c 79 20 71 75 65 75 65   currently queue
8370: 64 20 6f 70 65 72 61 74 69 6f 6e 73 0a 20 20 20  d operations.   
8380: 20 2a 2a 20 61 73 73 6f 63 69 61 74 65 64 20 77   ** associated w
8390: 69 74 68 20 74 68 65 20 73 61 6d 65 20 64 61 74  ith the same dat
83a0: 61 62 61 73 65 20 73 68 6f 75 6c 64 20 6e 6f 77  abase should now
83b0: 20 62 65 20 70 65 72 66 6f 72 6d 65 64 2e 20 4e   be performed. N
83c0: 6f 72 20 73 68 6f 75 6c 64 0a 20 20 20 20 2a 2a  or should.    **
83d0: 20 61 6e 79 20 73 75 62 73 65 71 75 65 6e 74 6c   any subsequentl
83e0: 79 20 72 65 71 75 65 73 74 65 64 20 49 4f 20 6f  y requested IO o
83f0: 6e 20 65 69 74 68 65 72 20 61 20 64 61 74 61 62  n either a datab
8400: 61 73 65 20 6f 72 20 6a 6f 75 72 6e 61 6c 20 66  ase or journal f
8410: 69 6c 65 20 0a 20 20 20 20 2a 2a 20 68 61 6e 64  ile .    ** hand
8420: 6c 65 20 66 6f 72 20 74 68 65 20 73 61 6d 65 20  le for the same 
8430: 64 61 74 61 62 61 73 65 20 62 65 20 61 63 63 65  database be acce
8440: 70 74 65 64 20 75 6e 74 69 6c 20 74 68 65 20 6d  pted until the m
8450: 61 69 6e 20 64 61 74 61 62 61 73 65 0a 20 20 20  ain database.   
8460: 20 2a 2a 20 66 69 6c 65 20 68 61 6e 64 6c 65 20   ** file handle 
8470: 68 61 73 20 62 65 65 6e 20 63 6c 6f 73 65 64 20  has been closed 
8480: 61 6e 64 20 72 65 6f 70 65 6e 65 64 2e 0a 20 20  and reopened..  
8490: 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 46 75 72 74    **.    ** Furt
84a0: 68 65 72 6d 6f 72 65 2c 20 6e 6f 20 66 75 72 74  hermore, no furt
84b0: 68 65 72 20 49 4f 20 73 68 6f 75 6c 64 20 62 65  her IO should be
84c0: 20 71 75 65 75 65 64 20 6f 72 20 70 65 72 66 6f   queued or perfo
84d0: 72 6d 65 64 20 6f 6e 20 61 6e 79 20 66 69 6c 65  rmed on any file
84e0: 0a 20 20 20 20 2a 2a 20 68 61 6e 64 6c 65 20 61  .    ** handle a
84f0: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61  ssociated with a
8500: 20 64 61 74 61 62 61 73 65 20 74 68 61 74 20 6d   database that m
8510: 61 79 20 68 61 76 65 20 62 65 65 6e 20 70 61 72  ay have been par
8520: 74 20 6f 66 20 61 20 0a 20 20 20 20 2a 2a 20 6d  t of a .    ** m
8530: 75 6c 74 69 2d 66 69 6c 65 20 74 72 61 6e 73 61  ulti-file transa
8540: 63 74 69 6f 6e 20 74 68 61 74 20 69 6e 63 6c 75  ction that inclu
8550: 64 65 64 20 74 68 65 20 64 61 74 61 62 61 73 65  ded the database
8560: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
8570: 20 0a 20 20 20 20 2a 2a 20 74 68 65 20 49 4f 20   .    ** the IO 
8580: 65 72 72 6f 72 20 28 69 2e 65 2e 20 61 20 64 61  error (i.e. a da
8590: 74 61 62 61 73 65 20 41 54 54 41 43 48 65 64 20  tabase ATTACHed 
85a0: 74 6f 20 74 68 65 20 73 61 6d 65 20 68 61 6e 64  to the same hand
85b0: 6c 65 20 61 74 20 73 6f 6d 65 20 0a 20 20 20 20  le at some .    
85c0: 2a 2a 20 70 6f 69 6e 74 20 69 6e 20 74 69 6d 65  ** point in time
85d0: 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66  )..    */.    if
85e0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
85f0: 29 7b 0a 20 20 20 20 20 20 61 73 79 6e 63 2e 69  ){.      async.i
8600: 6f 45 72 72 6f 72 20 3d 20 72 63 3b 0a 20 20 20  oError = rc;.   
8610: 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 72 6f 70 20   }..    /* Drop 
8620: 74 68 65 20 71 75 65 75 65 20 6d 75 74 65 78 20  the queue mutex 
8630: 62 65 66 6f 72 65 20 63 6f 6e 74 69 6e 75 69 6e  before continuin
8640: 67 20 74 6f 20 74 68 65 20 6e 65 78 74 20 77 72  g to the next wr
8650: 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 0a 20 20  ite operation.  
8660: 20 20 2a 2a 20 69 6e 20 6f 72 64 65 72 20 74 6f    ** in order to
8670: 20 67 69 76 65 20 6f 74 68 65 72 20 74 68 72 65   give other thre
8680: 61 64 73 20 61 20 63 68 61 6e 63 65 20 74 6f 20  ads a chance to 
8690: 77 6f 72 6b 20 77 69 74 68 20 74 68 65 20 77 72  work with the wr
86a0: 69 74 65 20 71 75 65 75 65 2e 0a 20 20 20 20 2a  ite queue..    *
86b0: 2f 0a 20 20 20 20 69 66 28 20 21 61 73 79 6e 63  /.    if( !async
86c0: 2e 70 51 75 65 75 65 46 69 72 73 74 20 7c 7c 20  .pQueueFirst || 
86d0: 21 61 73 79 6e 63 2e 69 6f 45 72 72 6f 72 20 29  !async.ioError )
86e0: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 41  {.      sqlite3A
86f0: 70 69 45 78 69 74 28 30 2c 20 30 29 3b 0a 20 20  piExit(0, 0);.  
8700: 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65      pthread_mute
8710: 78 5f 75 6e 6c 6f 63 6b 28 26 61 73 79 6e 63 2e  x_unlock(&async.
8720: 71 75 65 75 65 4d 75 74 65 78 29 3b 0a 20 20 20  queueMutex);.   
8730: 20 20 20 68 6f 6c 64 69 6e 67 4d 75 74 65 78 20     holdingMutex 
8740: 3d 20 30 3b 0a 20 20 20 20 20 20 69 66 28 20 61  = 0;.      if( a
8750: 73 79 6e 63 2e 69 6f 44 65 6c 61 79 3e 30 20 29  sync.ioDelay>0 )
8760: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  {.        sqlite
8770: 33 4f 73 53 6c 65 65 70 28 70 56 66 73 2c 20 61  3OsSleep(pVfs, a
8780: 73 79 6e 63 2e 69 6f 44 65 6c 61 79 29 3b 0a 20  sync.ioDelay);. 
8790: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
87a0: 20 20 20 20 73 63 68 65 64 5f 79 69 65 6c 64 28      sched_yield(
87b0: 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  );.      }.    }
87c0: 0a 20 20 7d 0a 20 20 0a 20 20 70 74 68 72 65 61  .  }.  .  pthrea
87d0: 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f 63 6b 28 26  d_mutex_unlock(&
87e0: 61 73 79 6e 63 2e 77 72 69 74 65 72 4d 75 74 65  async.writerMute
87f0: 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a  x);.  return 0;.
8800: 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  }../************
8810: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8820: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8830: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8840: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a  **************.*
8850: 2a 20 54 68 65 20 72 65 6d 61 69 6e 69 6e 67 20  * The remaining 
8860: 63 6f 64 65 20 64 65 66 69 6e 65 73 20 61 20 54  code defines a T
8870: 63 6c 20 69 6e 74 65 72 66 61 63 65 20 66 6f 72  cl interface for
8880: 20 74 65 73 74 69 6e 67 20 74 68 65 20 61 73 79   testing the asy
8890: 6e 63 68 72 6f 6e 6f 75 73 0a 2a 2a 20 49 4f 20  nchronous.** IO 
88a0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 69  implementation i
88b0: 6e 20 74 68 69 73 20 66 69 6c 65 2e 0a 2a 2a 0a  n this file..**.
88c0: 2a 2a 20 54 6f 20 61 64 61 70 74 20 74 68 65 20  ** To adapt the 
88d0: 63 6f 64 65 20 74 6f 20 61 20 6e 6f 6e 2d 54 43  code to a non-TC
88e0: 4c 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2c 20 64  L environment, d
88f0: 65 6c 65 74 65 20 6f 72 20 63 6f 6d 6d 65 6e 74  elete or comment
8900: 20 6f 75 74 0a 2a 2a 20 74 68 65 20 63 6f 64 65   out.** the code
8910: 20 74 68 61 74 20 66 6f 6c 6c 6f 77 73 2e 0a 2a   that follows..*
8920: 2f 0a 0a 2f 2a 0a 2a 2a 20 73 71 6c 69 74 65 33  /../*.** sqlite3
8930: 61 73 79 6e 63 5f 65 6e 61 62 6c 65 20 3f 59 45  async_enable ?YE
8940: 53 2f 4e 4f 3f 0a 2a 2a 0a 2a 2a 20 45 6e 61 62  S/NO?.**.** Enab
8950: 6c 65 20 6f 72 20 64 69 73 61 62 6c 65 20 74 68  le or disable th
8960: 65 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 49  e asynchronous I
8970: 2f 4f 20 62 61 63 6b 65 6e 64 2e 20 20 54 68 69  /O backend.  Thi
8980: 73 20 63 6f 6d 6d 61 6e 64 20 69 73 0a 2a 2a 20  s command is.** 
8990: 6e 6f 74 20 74 68 72 65 61 64 2d 73 61 66 65 2e  not thread-safe.
89a0: 20 20 44 6f 20 6e 6f 74 20 63 61 6c 6c 20 69 74    Do not call it
89b0: 20 77 68 69 6c 65 20 61 6e 79 20 64 61 74 61 62   while any datab
89c0: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a  ase connections.
89d0: 2a 2a 20 61 72 65 20 6f 70 65 6e 2e 0a 2a 2f 0a  ** are open..*/.
89e0: 73 74 61 74 69 63 20 69 6e 74 20 74 65 73 74 41  static int testA
89f0: 73 79 6e 63 45 6e 61 62 6c 65 28 0a 20 20 76 6f  syncEnable(.  vo
8a00: 69 64 20 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c  id * clientData,
8a10: 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69  .  Tcl_Interp *i
8a20: 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a  nterp,.  int obj
8a30: 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f  c,.  Tcl_Obj *CO
8a40: 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20  NST objv[].){.  
8a50: 69 66 28 20 6f 62 6a 63 21 3d 31 20 26 26 20 6f  if( objc!=1 && o
8a60: 62 6a 63 21 3d 32 20 29 7b 0a 20 20 20 20 54 63  bjc!=2 ){.    Tc
8a70: 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69  l_WrongNumArgs(i
8a80: 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 20  nterp, 1, objv, 
8a90: 22 3f 59 45 53 2f 4e 4f 3f 22 29 3b 0a 20 20 20  "?YES/NO?");.   
8aa0: 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f   return TCL_ERRO
8ab0: 52 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6f 62 6a  R;.  }.  if( obj
8ac0: 63 3d 3d 31 20 29 7b 0a 20 20 20 20 54 63 6c 5f  c==1 ){.    Tcl_
8ad0: 53 65 74 4f 62 6a 52 65 73 75 6c 74 28 69 6e 74  SetObjResult(int
8ae0: 65 72 70 2c 20 54 63 6c 5f 4e 65 77 42 6f 6f 6c  erp, Tcl_NewBool
8af0: 65 61 6e 4f 62 6a 28 61 73 79 6e 63 5f 76 66 73  eanObj(async_vfs
8b00: 2e 70 41 70 70 44 61 74 61 21 3d 30 29 29 3b 0a  .pAppData!=0));.
8b10: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 6e 74    }else{.    int
8b20: 20 65 6e 3b 0a 20 20 20 20 69 66 28 20 54 63 6c   en;.    if( Tcl
8b30: 5f 47 65 74 42 6f 6f 6c 65 61 6e 46 72 6f 6d 4f  _GetBooleanFromO
8b40: 62 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76 5b  bj(interp, objv[
8b50: 31 5d 2c 20 26 65 6e 29 20 29 20 72 65 74 75 72  1], &en) ) retur
8b60: 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 20  n TCL_ERROR;.   
8b70: 20 61 73 79 6e 63 45 6e 61 62 6c 65 28 65 6e 29   asyncEnable(en)
8b80: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 54  ;.  }.  return T
8b90: 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  CL_OK;.}../*.** 
8ba0: 73 71 6c 69 74 65 33 61 73 79 6e 63 5f 68 61 6c  sqlite3async_hal
8bb0: 74 20 20 22 6e 6f 77 22 7c 22 69 64 6c 65 22 7c  t  "now"|"idle"|
8bc0: 22 6e 65 76 65 72 22 0a 2a 2a 0a 2a 2a 20 53 65  "never".**.** Se
8bd0: 74 20 74 68 65 20 63 6f 6e 64 69 74 69 6f 6e 73  t the conditions
8be0: 20 61 74 20 77 68 69 63 68 20 74 68 65 20 77 72   at which the wr
8bf0: 69 74 65 72 20 74 68 72 65 61 64 20 77 69 6c 6c  iter thread will
8c00: 20 68 61 6c 74 2e 0a 2a 2f 0a 73 74 61 74 69 63   halt..*/.static
8c10: 20 69 6e 74 20 74 65 73 74 41 73 79 6e 63 48 61   int testAsyncHa
8c20: 6c 74 28 0a 20 20 76 6f 69 64 20 2a 20 63 6c 69  lt(.  void * cli
8c30: 65 6e 74 44 61 74 61 2c 0a 20 20 54 63 6c 5f 49  entData,.  Tcl_I
8c40: 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c 0a 20  nterp *interp,. 
8c50: 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54 63 6c   int objc,.  Tcl
8c60: 5f 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62 6a 76  _Obj *CONST objv
8c70: 5b 5d 0a 29 7b 0a 20 20 63 6f 6e 73 74 20 63 68  [].){.  const ch
8c80: 61 72 20 2a 7a 43 6f 6e 64 3b 0a 20 20 69 66 28  ar *zCond;.  if(
8c90: 20 6f 62 6a 63 21 3d 32 20 29 7b 0a 20 20 20 20   objc!=2 ){.    
8ca0: 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67 73  Tcl_WrongNumArgs
8cb0: 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a 76  (interp, 1, objv
8cc0: 2c 20 22 5c 22 6e 6f 77 5c 22 7c 5c 22 69 64 6c  , "\"now\"|\"idl
8cd0: 65 5c 22 7c 5c 22 6e 65 76 65 72 5c 22 22 29 3b  e\"|\"never\"");
8ce0: 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  .    return TCL_
8cf0: 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 7a 43 6f  ERROR;.  }.  zCo
8d00: 6e 64 20 3d 20 54 63 6c 5f 47 65 74 53 74 72 69  nd = Tcl_GetStri
8d10: 6e 67 28 6f 62 6a 76 5b 31 5d 29 3b 0a 20 20 69  ng(objv[1]);.  i
8d20: 66 28 20 73 74 72 63 6d 70 28 7a 43 6f 6e 64 2c  f( strcmp(zCond,
8d30: 20 22 6e 6f 77 22 29 3d 3d 30 20 29 7b 0a 20 20   "now")==0 ){.  
8d40: 20 20 61 73 79 6e 63 2e 77 72 69 74 65 72 48 61    async.writerHa
8d50: 6c 74 4e 6f 77 20 3d 20 31 3b 0a 20 20 20 20 70  ltNow = 1;.    p
8d60: 74 68 72 65 61 64 5f 63 6f 6e 64 5f 62 72 6f 61  thread_cond_broa
8d70: 64 63 61 73 74 28 26 61 73 79 6e 63 2e 71 75 65  dcast(&async.que
8d80: 75 65 53 69 67 6e 61 6c 29 3b 0a 20 20 7d 65 6c  ueSignal);.  }el
8d90: 73 65 20 69 66 28 20 73 74 72 63 6d 70 28 7a 43  se if( strcmp(zC
8da0: 6f 6e 64 2c 20 22 69 64 6c 65 22 29 3d 3d 30 20  ond, "idle")==0 
8db0: 29 7b 0a 20 20 20 20 61 73 79 6e 63 2e 77 72 69  ){.    async.wri
8dc0: 74 65 72 48 61 6c 74 57 68 65 6e 49 64 6c 65 20  terHaltWhenIdle 
8dd0: 3d 20 31 3b 0a 20 20 20 20 61 73 79 6e 63 2e 77  = 1;.    async.w
8de0: 72 69 74 65 72 48 61 6c 74 4e 6f 77 20 3d 20 30  riterHaltNow = 0
8df0: 3b 0a 20 20 20 20 70 74 68 72 65 61 64 5f 63 6f  ;.    pthread_co
8e00: 6e 64 5f 62 72 6f 61 64 63 61 73 74 28 26 61 73  nd_broadcast(&as
8e10: 79 6e 63 2e 71 75 65 75 65 53 69 67 6e 61 6c 29  ync.queueSignal)
8e20: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 73 74  ;.  }else if( st
8e30: 72 63 6d 70 28 7a 43 6f 6e 64 2c 20 22 6e 65 76  rcmp(zCond, "nev
8e40: 65 72 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20 61  er")==0 ){.    a
8e50: 73 79 6e 63 2e 77 72 69 74 65 72 48 61 6c 74 57  sync.writerHaltW
8e60: 68 65 6e 49 64 6c 65 20 3d 20 30 3b 0a 20 20 20  henIdle = 0;.   
8e70: 20 61 73 79 6e 63 2e 77 72 69 74 65 72 48 61 6c   async.writerHal
8e80: 74 4e 6f 77 20 3d 20 30 3b 0a 20 20 7d 65 6c 73  tNow = 0;.  }els
8e90: 65 7b 0a 20 20 20 20 54 63 6c 5f 41 70 70 65 6e  e{.    Tcl_Appen
8ea0: 64 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20  dResult(interp, 
8eb0: 0a 20 20 20 20 20 20 22 73 68 6f 75 6c 64 20 62  .      "should b
8ec0: 65 20 6f 6e 65 20 6f 66 3a 20 5c 22 6e 6f 77 5c  e one of: \"now\
8ed0: 22 2c 20 5c 22 69 64 6c 65 5c 22 2c 20 6f 72 20  ", \"idle\", or 
8ee0: 5c 22 6e 65 76 65 72 5c 22 22 2c 20 28 63 68 61  \"never\"", (cha
8ef0: 72 2a 29 30 29 3b 0a 20 20 20 20 72 65 74 75 72  r*)0);.    retur
8f00: 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 7d  n TCL_ERROR;.  }
8f10: 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b  .  return TCL_OK
8f20: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 73 71 6c 69 74  ;.}../*.** sqlit
8f30: 65 33 61 73 79 6e 63 5f 64 65 6c 61 79 20 3f 4d  e3async_delay ?M
8f40: 53 3f 0a 2a 2a 0a 2a 2a 20 51 75 65 72 79 20 6f  S?.**.** Query o
8f50: 72 20 73 65 74 20 74 68 65 20 6e 75 6d 62 65 72  r set the number
8f60: 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73   of milliseconds
8f70: 20 6f 66 20 64 65 6c 61 79 20 69 6e 20 74 68 65   of delay in the
8f80: 20 77 72 69 74 65 72 0a 2a 2a 20 74 68 72 65 61   writer.** threa
8f90: 64 20 61 66 74 65 72 20 65 61 63 68 20 77 72 69  d after each wri
8fa0: 74 65 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 54  te operation.  T
8fb0: 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 30 2e  he default is 0.
8fc0: 20 20 42 79 20 69 6e 63 72 65 61 73 69 6e 67 0a    By increasing.
8fd0: 2a 2a 20 74 68 65 20 6d 65 6d 6f 72 79 20 64 65  ** the memory de
8fe0: 6c 61 79 20 77 65 20 63 61 6e 20 73 69 6d 75 6c  lay we can simul
8ff0: 61 74 65 20 74 68 65 20 65 66 66 65 63 74 20 6f  ate the effect o
9000: 66 20 73 6c 6f 77 20 64 69 73 6b 20 49 2f 4f 2e  f slow disk I/O.
9010: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 74  .*/.static int t
9020: 65 73 74 41 73 79 6e 63 44 65 6c 61 79 28 0a 20  estAsyncDelay(. 
9030: 20 76 6f 69 64 20 2a 20 63 6c 69 65 6e 74 44 61   void * clientDa
9040: 74 61 2c 0a 20 20 54 63 6c 5f 49 6e 74 65 72 70  ta,.  Tcl_Interp
9050: 20 2a 69 6e 74 65 72 70 2c 0a 20 20 69 6e 74 20   *interp,.  int 
9060: 6f 62 6a 63 2c 0a 20 20 54 63 6c 5f 4f 62 6a 20  objc,.  Tcl_Obj 
9070: 2a 43 4f 4e 53 54 20 6f 62 6a 76 5b 5d 0a 29 7b  *CONST objv[].){
9080: 0a 20 20 69 66 28 20 6f 62 6a 63 21 3d 31 20 26  .  if( objc!=1 &
9090: 26 20 6f 62 6a 63 21 3d 32 20 29 7b 0a 20 20 20  & objc!=2 ){.   
90a0: 20 54 63 6c 5f 57 72 6f 6e 67 4e 75 6d 41 72 67   Tcl_WrongNumArg
90b0: 73 28 69 6e 74 65 72 70 2c 20 31 2c 20 6f 62 6a  s(interp, 1, obj
90c0: 76 2c 20 22 3f 4d 53 3f 22 29 3b 0a 20 20 20 20  v, "?MS?");.    
90d0: 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52  return TCL_ERROR
90e0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6f 62 6a 63  ;.  }.  if( objc
90f0: 3d 3d 31 20 29 7b 0a 20 20 20 20 54 63 6c 5f 53  ==1 ){.    Tcl_S
9100: 65 74 4f 62 6a 52 65 73 75 6c 74 28 69 6e 74 65  etObjResult(inte
9110: 72 70 2c 20 54 63 6c 5f 4e 65 77 49 6e 74 4f 62  rp, Tcl_NewIntOb
9120: 6a 28 61 73 79 6e 63 2e 69 6f 44 65 6c 61 79 29  j(async.ioDelay)
9130: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  );.  }else{.    
9140: 69 6e 74 20 69 6f 44 65 6c 61 79 3b 0a 20 20 20  int ioDelay;.   
9150: 20 69 66 28 20 54 63 6c 5f 47 65 74 49 6e 74 46   if( Tcl_GetIntF
9160: 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 6f  romObj(interp, o
9170: 62 6a 76 5b 31 5d 2c 20 26 69 6f 44 65 6c 61 79  bjv[1], &ioDelay
9180: 29 20 29 20 72 65 74 75 72 6e 20 54 43 4c 5f 45  ) ) return TCL_E
9190: 52 52 4f 52 3b 0a 20 20 20 20 61 73 79 6e 63 2e  RROR;.    async.
91a0: 69 6f 44 65 6c 61 79 20 3d 20 69 6f 44 65 6c 61  ioDelay = ioDela
91b0: 79 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  y;.  }.  return 
91c0: 54 43 4c 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  TCL_OK;.}../*.**
91d0: 20 73 71 6c 69 74 65 33 61 73 79 6e 63 5f 73 74   sqlite3async_st
91e0: 61 72 74 0a 2a 2a 0a 2a 2a 20 53 74 61 72 74 20  art.**.** Start 
91f0: 61 20 6e 65 77 20 77 72 69 74 65 72 20 74 68 72  a new writer thr
9200: 65 61 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ead..*/.static i
9210: 6e 74 20 74 65 73 74 41 73 79 6e 63 53 74 61 72  nt testAsyncStar
9220: 74 28 0a 20 20 76 6f 69 64 20 2a 20 63 6c 69 65  t(.  void * clie
9230: 6e 74 44 61 74 61 2c 0a 20 20 54 63 6c 5f 49 6e  ntData,.  Tcl_In
9240: 74 65 72 70 20 2a 69 6e 74 65 72 70 2c 0a 20 20  terp *interp,.  
9250: 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 54 63 6c 5f  int objc,.  Tcl_
9260: 4f 62 6a 20 2a 43 4f 4e 53 54 20 6f 62 6a 76 5b  Obj *CONST objv[
9270: 5d 0a 29 7b 0a 20 20 70 74 68 72 65 61 64 5f 74  ].){.  pthread_t
9280: 20 78 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20   x;.  int rc;.  
9290: 72 63 20 3d 20 70 74 68 72 65 61 64 5f 63 72 65  rc = pthread_cre
92a0: 61 74 65 28 26 78 2c 20 30 2c 20 61 73 79 6e 63  ate(&x, 0, async
92b0: 57 72 69 74 65 72 54 68 72 65 61 64 2c 20 30 29  WriterThread, 0)
92c0: 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20  ;.  if( rc ){.  
92d0: 20 20 54 63 6c 5f 41 70 70 65 6e 64 52 65 73 75    Tcl_AppendResu
92e0: 6c 74 28 69 6e 74 65 72 70 2c 20 22 66 61 69 6c  lt(interp, "fail
92f0: 65 64 20 74 6f 20 63 72 65 61 74 65 20 74 68 65  ed to create the
9300: 20 74 68 72 65 61 64 22 2c 20 30 29 3b 0a 20 20   thread", 0);.  
9310: 20 20 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52    return TCL_ERR
9320: 4f 52 3b 0a 20 20 7d 0a 20 20 70 74 68 72 65 61  OR;.  }.  pthrea
9330: 64 5f 64 65 74 61 63 68 28 78 29 3b 0a 20 20 72  d_detach(x);.  r
9340: 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 7d 0a  eturn TCL_OK;.}.
9350: 0a 2f 2a 0a 2a 2a 20 73 71 6c 69 74 65 33 61 73  ./*.** sqlite3as
9360: 79 6e 63 5f 77 61 69 74 0a 2a 2a 0a 2a 2a 20 57  ync_wait.**.** W
9370: 61 69 74 20 66 6f 72 20 74 68 65 20 63 75 72 72  ait for the curr
9380: 65 6e 74 20 77 72 69 74 65 72 20 74 68 72 65 61  ent writer threa
9390: 64 20 74 6f 20 74 65 72 6d 69 6e 61 74 65 2e 0a  d to terminate..
93a0: 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63 75 72  **.** If the cur
93b0: 72 65 6e 74 20 77 72 69 74 65 72 20 74 68 72 65  rent writer thre
93c0: 61 64 20 69 73 20 73 65 74 20 74 6f 20 72 75 6e  ad is set to run
93d0: 20 66 6f 72 65 76 65 72 20 74 68 65 6e 20 74 68   forever then th
93e0: 69 73 0a 2a 2a 20 63 6f 6d 6d 61 6e 64 20 77 6f  is.** command wo
93f0: 75 6c 64 20 62 6c 6f 63 6b 20 66 6f 72 65 76 65  uld block foreve
9400: 72 2e 20 20 54 6f 20 70 72 65 76 65 6e 74 20 74  r.  To prevent t
9410: 68 61 74 2c 20 61 6e 20 65 72 72 6f 72 20 69 73  hat, an error is
9420: 20 72 65 74 75 72 6e 65 64 2e 20 0a 2a 2f 0a 73   returned. .*/.s
9430: 74 61 74 69 63 20 69 6e 74 20 74 65 73 74 41 73  tatic int testAs
9440: 79 6e 63 57 61 69 74 28 0a 20 20 76 6f 69 64 20  yncWait(.  void 
9450: 2a 20 63 6c 69 65 6e 74 44 61 74 61 2c 0a 20 20  * clientData,.  
9460: 54 63 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65  Tcl_Interp *inte
9470: 72 70 2c 0a 20 20 69 6e 74 20 6f 62 6a 63 2c 0a  rp,.  int objc,.
9480: 20 20 54 63 6c 5f 4f 62 6a 20 2a 43 4f 4e 53 54    Tcl_Obj *CONST
9490: 20 6f 62 6a 76 5b 5d 0a 29 7b 0a 20 20 69 6e 74   objv[].){.  int
94a0: 20 63 6e 74 20 3d 20 31 30 3b 0a 20 20 69 66 28   cnt = 10;.  if(
94b0: 20 61 73 79 6e 63 2e 77 72 69 74 65 72 48 61 6c   async.writerHal
94c0: 74 4e 6f 77 3d 3d 30 20 26 26 20 61 73 79 6e 63  tNow==0 && async
94d0: 2e 77 72 69 74 65 72 48 61 6c 74 57 68 65 6e 49  .writerHaltWhenI
94e0: 64 6c 65 3d 3d 30 20 29 7b 0a 20 20 20 20 54 63  dle==0 ){.    Tc
94f0: 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c 74 28 69  l_AppendResult(i
9500: 6e 74 65 72 70 2c 20 22 77 6f 75 6c 64 20 62 6c  nterp, "would bl
9510: 6f 63 6b 20 66 6f 72 65 76 65 72 22 2c 20 28 63  ock forever", (c
9520: 68 61 72 2a 29 30 29 3b 0a 20 20 20 20 72 65 74  har*)0);.    ret
9530: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 20  urn TCL_ERROR;. 
9540: 20 7d 0a 0a 20 20 77 68 69 6c 65 28 20 63 6e 74   }..  while( cnt
9550: 2d 2d 20 26 26 20 21 70 74 68 72 65 61 64 5f 6d  -- && !pthread_m
9560: 75 74 65 78 5f 74 72 79 6c 6f 63 6b 28 26 61 73  utex_trylock(&as
9570: 79 6e 63 2e 77 72 69 74 65 72 4d 75 74 65 78 29  ync.writerMutex)
9580: 20 29 7b 0a 20 20 20 20 70 74 68 72 65 61 64 5f   ){.    pthread_
9590: 6d 75 74 65 78 5f 75 6e 6c 6f 63 6b 28 26 61 73  mutex_unlock(&as
95a0: 79 6e 63 2e 77 72 69 74 65 72 4d 75 74 65 78 29  ync.writerMutex)
95b0: 3b 0a 20 20 20 20 73 63 68 65 64 5f 79 69 65 6c  ;.    sched_yiel
95c0: 64 28 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 63  d();.  }.  if( c
95d0: 6e 74 3e 3d 30 20 29 7b 0a 20 20 20 20 41 53 59  nt>=0 ){.    ASY
95e0: 4e 43 5f 54 52 41 43 45 28 28 22 57 41 49 54 5c  NC_TRACE(("WAIT\
95f0: 6e 22 29 29 3b 0a 20 20 20 20 70 74 68 72 65 61  n"));.    pthrea
9600: 64 5f 6d 75 74 65 78 5f 6c 6f 63 6b 28 26 61 73  d_mutex_lock(&as
9610: 79 6e 63 2e 71 75 65 75 65 4d 75 74 65 78 29 3b  ync.queueMutex);
9620: 0a 20 20 20 20 70 74 68 72 65 61 64 5f 63 6f 6e  .    pthread_con
9630: 64 5f 62 72 6f 61 64 63 61 73 74 28 26 61 73 79  d_broadcast(&asy
9640: 6e 63 2e 71 75 65 75 65 53 69 67 6e 61 6c 29 3b  nc.queueSignal);
9650: 0a 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75 74  .    pthread_mut
9660: 65 78 5f 75 6e 6c 6f 63 6b 28 26 61 73 79 6e 63  ex_unlock(&async
9670: 2e 71 75 65 75 65 4d 75 74 65 78 29 3b 0a 20 20  .queueMutex);.  
9680: 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f    pthread_mutex_
9690: 6c 6f 63 6b 28 26 61 73 79 6e 63 2e 77 72 69 74  lock(&async.writ
96a0: 65 72 4d 75 74 65 78 29 3b 0a 20 20 20 20 70 74  erMutex);.    pt
96b0: 68 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f  hread_mutex_unlo
96c0: 63 6b 28 26 61 73 79 6e 63 2e 77 72 69 74 65 72  ck(&async.writer
96d0: 4d 75 74 65 78 29 3b 0a 20 20 7d 65 6c 73 65 7b  Mutex);.  }else{
96e0: 0a 20 20 20 20 41 53 59 4e 43 5f 54 52 41 43 45  .    ASYNC_TRACE
96f0: 28 28 22 4e 4f 2d 57 41 49 54 5c 6e 22 29 29 3b  (("NO-WAIT\n"));
9700: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 54 43  .  }.  return TC
9710: 4c 5f 4f 4b 3b 0a 7d 0a 0a 0a 23 65 6e 64 69 66  L_OK;.}...#endif
9720: 20 20 2f 2a 20 4f 53 5f 55 4e 49 58 20 61 6e 64    /* OS_UNIX and
9730: 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41   SQLITE_THREADSA
9740: 46 45 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 69  FE */../*.** Thi
9750: 73 20 72 6f 75 74 69 6e 65 20 72 65 67 69 73 74  s routine regist
9760: 65 72 73 20 74 68 65 20 63 75 73 74 6f 6d 20 54  ers the custom T
9770: 43 4c 20 63 6f 6d 6d 61 6e 64 73 20 64 65 66 69  CL commands defi
9780: 6e 65 64 20 69 6e 20 74 68 69 73 0a 2a 2a 20 6d  ned in this.** m
9790: 6f 64 75 6c 65 2e 20 20 54 68 69 73 20 73 68 6f  odule.  This sho
97a0: 75 6c 64 20 62 65 20 74 68 65 20 6f 6e 6c 79 20  uld be the only 
97b0: 70 72 6f 63 65 64 75 72 65 20 76 69 73 69 62 6c  procedure visibl
97c0: 65 20 66 72 6f 6d 20 6f 75 74 73 69 64 65 0a 2a  e from outside.*
97d0: 2a 20 6f 66 20 74 68 69 73 20 6d 6f 64 75 6c 65  * of this module
97e0: 2e 0a 2a 2f 0a 69 6e 74 20 53 71 6c 69 74 65 74  ..*/.int Sqlitet
97f0: 65 73 74 61 73 79 6e 63 5f 49 6e 69 74 28 54 63  estasync_Init(Tc
9800: 6c 5f 49 6e 74 65 72 70 20 2a 69 6e 74 65 72 70  l_Interp *interp
9810: 29 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58 20 26  ){.#if OS_UNIX &
9820: 26 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53  & SQLITE_THREADS
9830: 41 46 45 0a 20 20 54 63 6c 5f 43 72 65 61 74 65  AFE.  Tcl_Create
9840: 4f 62 6a 43 6f 6d 6d 61 6e 64 28 69 6e 74 65 72  ObjCommand(inter
9850: 70 2c 22 73 71 6c 69 74 65 33 61 73 79 6e 63 5f  p,"sqlite3async_
9860: 65 6e 61 62 6c 65 22 2c 74 65 73 74 41 73 79 6e  enable",testAsyn
9870: 63 45 6e 61 62 6c 65 2c 30 2c 30 29 3b 0a 20 20  cEnable,0,0);.  
9880: 54 63 6c 5f 43 72 65 61 74 65 4f 62 6a 43 6f 6d  Tcl_CreateObjCom
9890: 6d 61 6e 64 28 69 6e 74 65 72 70 2c 22 73 71 6c  mand(interp,"sql
98a0: 69 74 65 33 61 73 79 6e 63 5f 68 61 6c 74 22 2c  ite3async_halt",
98b0: 74 65 73 74 41 73 79 6e 63 48 61 6c 74 2c 30 2c  testAsyncHalt,0,
98c0: 30 29 3b 0a 20 20 54 63 6c 5f 43 72 65 61 74 65  0);.  Tcl_Create
98d0: 4f 62 6a 43 6f 6d 6d 61 6e 64 28 69 6e 74 65 72  ObjCommand(inter
98e0: 70 2c 22 73 71 6c 69 74 65 33 61 73 79 6e 63 5f  p,"sqlite3async_
98f0: 64 65 6c 61 79 22 2c 74 65 73 74 41 73 79 6e 63  delay",testAsync
9900: 44 65 6c 61 79 2c 30 2c 30 29 3b 0a 20 20 54 63  Delay,0,0);.  Tc
9910: 6c 5f 43 72 65 61 74 65 4f 62 6a 43 6f 6d 6d 61  l_CreateObjComma
9920: 6e 64 28 69 6e 74 65 72 70 2c 22 73 71 6c 69 74  nd(interp,"sqlit
9930: 65 33 61 73 79 6e 63 5f 73 74 61 72 74 22 2c 74  e3async_start",t
9940: 65 73 74 41 73 79 6e 63 53 74 61 72 74 2c 30 2c  estAsyncStart,0,
9950: 30 29 3b 0a 20 20 54 63 6c 5f 43 72 65 61 74 65  0);.  Tcl_Create
9960: 4f 62 6a 43 6f 6d 6d 61 6e 64 28 69 6e 74 65 72  ObjCommand(inter
9970: 70 2c 22 73 71 6c 69 74 65 33 61 73 79 6e 63 5f  p,"sqlite3async_
9980: 77 61 69 74 22 2c 74 65 73 74 41 73 79 6e 63 57  wait",testAsyncW
9990: 61 69 74 2c 30 2c 30 29 3b 0a 20 20 54 63 6c 5f  ait,0,0);.  Tcl_
99a0: 4c 69 6e 6b 56 61 72 28 69 6e 74 65 72 70 2c 20  LinkVar(interp, 
99b0: 22 73 71 6c 69 74 65 33 61 73 79 6e 63 5f 74 72  "sqlite3async_tr
99c0: 61 63 65 22 2c 0a 20 20 20 20 20 20 28 63 68 61  ace",.      (cha
99d0: 72 2a 29 26 73 71 6c 69 74 65 33 61 73 79 6e 63  r*)&sqlite3async
99e0: 5f 74 72 61 63 65 2c 20 54 43 4c 5f 4c 49 4e 4b  _trace, TCL_LINK
99f0: 5f 49 4e 54 29 3b 0a 23 65 6e 64 69 66 20 20 2f  _INT);.#endif  /
9a00: 2a 20 4f 53 5f 55 4e 49 58 20 61 6e 64 20 53 51  * OS_UNIX and SQ
9a10: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 20  LITE_THREADSAFE 
9a20: 2a 2f 0a 20 20 72 65 74 75 72 6e 20 54 43 4c 5f  */.  return TCL_
9a30: 4f 4b 3b 0a 7d 0a                                OK;.}.