/ Hex Artifact Content
Login

Artifact 67b2efd36a1e67a7dc7b7fa852fd69953462c943:


0000: 2f 2a 0a 2a 2a 20 32 30 30 37 20 41 75 67 75 73  /*.** 2007 Augus
0010: 74 20 31 34 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61  t 14.**.** The a
0020: 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20  uthor disclaims 
0030: 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74 68 69  copyright to thi
0040: 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20  s source code.  
0050: 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61  In place of.** a
0060: 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68   legal notice, h
0070: 65 72 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e  ere is a blessin
0080: 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20  g:.**.**    May 
0090: 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20  you do good and 
00a0: 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20  not evil..**    
00b0: 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72  May you find for
00c0: 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75  giveness for you
00d0: 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76  rself and forgiv
00e0: 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20  e others..**    
00f0: 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20 66 72  May you share fr
0100: 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69  eely, never taki
0110: 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75  ng more than you
0120: 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a   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 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65  ***.** This file
0180: 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 43 20   contains the C 
0190: 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 69  functions that i
01a0: 6d 70 6c 65 6d 65 6e 74 20 6d 75 74 65 78 65 73  mplement mutexes
01b0: 20 66 6f 72 0a 2a 2a 20 75 73 65 20 62 79 20 74   for.** use by t
01c0: 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 2e 0a  he SQLite core..
01d0: 2a 2a 0a 2a 2a 20 24 49 64 3a 20 6d 75 74 65 78  **.** $Id: mutex
01e0: 2e 63 2c 76 20 31 2e 34 20 32 30 30 37 2f 30 38  .c,v 1.4 2007/08
01f0: 2f 31 37 20 30 31 3a 31 34 3a 33 38 20 64 72 68  /17 01:14:38 drh
0200: 20 45 78 70 20 24 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a   Exp $.*/../*.**
0210: 20 49 66 20 53 51 4c 49 54 45 5f 4d 55 54 45 58   If SQLITE_MUTEX
0220: 5f 41 50 50 44 45 46 20 69 73 20 64 65 66 69 6e  _APPDEF is defin
0230: 65 64 2c 20 74 68 65 6e 20 74 68 69 73 20 77 68  ed, then this wh
0240: 6f 6c 65 20 6d 6f 64 75 6c 65 20 69 73 0a 2a 2a  ole module is.**
0250: 20 6f 6d 69 74 74 65 64 20 61 6e 64 20 65 71 75   omitted and equ
0260: 69 76 61 6c 65 6e 74 20 66 75 6e 63 74 69 6f 6e  ivalent function
0270: 61 6c 69 74 79 20 6a 75 73 74 20 62 65 20 70 72  ality just be pr
0280: 6f 76 69 64 65 64 20 62 79 20 74 68 65 0a 2a 2a  ovided by the.**
0290: 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 74 68 61   application tha
02a0: 74 20 6c 69 6e 6b 73 20 61 67 61 69 6e 73 74 20  t links against 
02b0: 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61  the SQLite libra
02c0: 72 79 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53  ry..*/.#ifndef S
02d0: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 41 50 50 44  QLITE_MUTEX_APPD
02e0: 45 46 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 74  EF../*.** The st
02f0: 61 72 74 20 6f 66 20 72 65 61 6c 20 63 6f 64 65  art of real code
0300: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71  .*/.#include "sq
0310: 6c 69 74 65 49 6e 74 2e 68 22 0a 0a 2f 2a 2a 2a  liteInt.h"../***
0320: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0330: 2a 2a 2a 2a 2a 20 4e 6f 2d 6f 70 20 4d 75 74 65  ***** No-op Mute
0340: 78 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  x Implementation
0350: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a   ***************
0360: 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 68  *******.**.** Th
0370: 69 73 20 66 69 72 73 74 20 69 6d 70 6c 65 6d 65  is first impleme
0380: 6e 74 61 74 69 6f 6e 20 6f 66 20 6d 75 74 65 78  ntation of mutex
0390: 65 73 20 69 73 20 72 65 61 6c 6c 79 20 61 20 6e  es is really a n
03a0: 6f 2d 6f 70 2e 20 20 49 6e 20 6f 74 68 65 72 20  o-op.  In other 
03b0: 77 6f 72 64 73 2c 0a 2a 2a 20 6e 6f 20 72 65 61  words,.** no rea
03c0: 6c 20 6c 6f 63 6b 69 6e 67 20 6f 63 63 75 72 73  l locking occurs
03d0: 2e 20 20 54 68 69 73 20 69 6d 70 6c 65 6d 65 6e  .  This implemen
03e0: 74 61 74 69 6f 6e 20 69 73 20 61 70 70 72 6f 70  tation is approp
03f0: 72 69 61 74 65 20 66 6f 72 20 75 73 65 0a 2a 2a  riate for use.**
0400: 20 69 6e 20 73 69 6e 67 6c 65 20 74 68 72 65 61   in single threa
0410: 64 65 64 20 61 70 70 6c 69 63 61 74 69 6f 6e 73  ded applications
0420: 20 77 68 69 63 68 20 64 6f 20 6e 6f 74 20 77 61   which do not wa
0430: 6e 74 20 74 68 65 20 65 78 74 72 61 20 6f 76 65  nt the extra ove
0440: 72 68 65 61 64 0a 2a 2a 20 6f 66 20 74 68 72 65  rhead.** of thre
0450: 61 64 20 6c 6f 63 6b 69 6e 67 20 70 72 69 6d 69  ad locking primi
0460: 74 69 76 65 73 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a  tives..*/../*.**
0470: 20 54 68 65 20 73 71 6c 69 74 65 33 5f 6d 75 74   The sqlite3_mut
0480: 65 78 5f 61 6c 6c 6f 63 28 29 20 72 6f 75 74 69  ex_alloc() routi
0490: 6e 65 20 61 6c 6c 6f 63 61 74 65 73 20 61 20 6e  ne allocates a n
04a0: 65 77 0a 2a 2a 20 6d 75 74 65 78 20 61 6e 64 20  ew.** mutex and 
04b0: 72 65 74 75 72 6e 73 20 61 20 70 6f 69 6e 74 65  returns a pointe
04c0: 72 20 74 6f 20 69 74 2e 20 20 49 66 20 69 74 20  r to it.  If it 
04d0: 72 65 74 75 72 6e 73 20 4e 55 4c 4c 0a 2a 2a 20  returns NULL.** 
04e0: 74 68 61 74 20 6d 65 61 6e 73 20 74 68 61 74 20  that means that 
04f0: 61 20 6d 75 74 65 78 20 63 6f 75 6c 64 20 6e 6f  a mutex could no
0500: 74 20 62 65 20 61 6c 6c 6f 63 61 74 65 64 2e 20  t be allocated. 
0510: 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 6d 75 74 65  .*/.sqlite3_mute
0520: 78 20 2a 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  x *sqlite3_mutex
0530: 5f 61 6c 6c 6f 63 28 69 6e 74 20 69 64 4e 6f 74  _alloc(int idNot
0540: 55 73 65 64 29 7b 0a 20 20 72 65 74 75 72 6e 20  Used){.  return 
0550: 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 2a 29  (sqlite3_mutex*)
0560: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c  sqlite3_mutex_al
0570: 6c 6f 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68  loc;.}../*.** Th
0580: 69 73 20 72 6f 75 74 69 6e 65 20 64 65 61 6c 6c  is routine deall
0590: 6f 63 61 74 65 73 20 61 20 70 72 65 76 69 6f 75  ocates a previou
05a0: 73 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 6d 75  sly allocated mu
05b0: 74 65 78 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  tex..*/.void sql
05c0: 69 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 65 28  ite3_mutex_free(
05d0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 70  sqlite3_mutex *p
05e0: 4e 6f 74 55 73 65 64 29 7b 7d 0a 0a 2f 2a 0a 2a  NotUsed){}../*.*
05f0: 2a 20 54 68 65 20 73 71 6c 69 74 65 33 5f 6d 75  * The sqlite3_mu
0600: 74 65 78 5f 65 6e 74 65 72 28 29 20 61 6e 64 20  tex_enter() and 
0610: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 74 72  sqlite3_mutex_tr
0620: 79 28 29 20 72 6f 75 74 69 6e 65 73 20 61 74 74  y() routines att
0630: 65 6d 70 74 0a 2a 2a 20 74 6f 20 65 6e 74 65 72  empt.** to enter
0640: 20 61 20 6d 75 74 65 78 2e 20 20 49 66 20 61 6e   a mutex.  If an
0650: 6f 74 68 65 72 20 74 68 72 65 61 64 20 69 73 20  other thread is 
0660: 61 6c 72 65 61 64 79 20 77 69 74 68 69 6e 20 74  already within t
0670: 68 65 20 6d 75 74 65 78 2c 0a 2a 2a 20 73 71 6c  he mutex,.** sql
0680: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
0690: 28 29 20 77 69 6c 6c 20 62 6c 6f 63 6b 20 61 6e  () will block an
06a0: 64 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  d sqlite3_mutex_
06b0: 74 72 79 28 29 20 77 69 6c 6c 20 72 65 74 75 72  try() will retur
06c0: 6e 0a 2a 2a 20 53 51 4c 49 54 45 5f 42 55 53 59  n.** SQLITE_BUSY
06d0: 2e 20 20 54 68 65 20 73 71 6c 69 74 65 33 5f 6d  .  The sqlite3_m
06e0: 75 74 65 78 5f 74 72 79 28 29 20 69 6e 74 65 72  utex_try() inter
06f0: 66 61 63 65 20 72 65 74 75 72 6e 73 20 53 51 4c  face returns SQL
0700: 49 54 45 5f 4f 4b 0a 2a 2a 20 75 70 6f 6e 20 73  ITE_OK.** upon s
0710: 75 63 63 65 73 73 66 75 6c 20 65 6e 74 72 79 2e  uccessful entry.
0720: 20 20 4d 75 74 65 78 65 73 20 63 72 65 61 74 65    Mutexes create
0730: 64 20 75 73 69 6e 67 20 53 51 4c 49 54 45 5f 4d  d using SQLITE_M
0740: 55 54 45 58 5f 52 45 43 55 52 53 49 56 45 20 63  UTEX_RECURSIVE c
0750: 61 6e 0a 2a 2a 20 62 65 20 65 6e 74 65 72 65 64  an.** be entered
0760: 20 6d 75 6c 74 69 70 6c 65 20 74 69 6d 65 73 20   multiple times 
0770: 62 79 20 74 68 65 20 73 61 6d 65 20 74 68 72 65  by the same thre
0780: 61 64 2e 20 20 49 6e 20 73 75 63 68 20 63 61 73  ad.  In such cas
0790: 65 73 20 74 68 65 2c 0a 2a 2a 20 6d 75 74 65 78  es the,.** mutex
07a0: 20 6d 75 73 74 20 62 65 20 65 78 69 74 65 64 20   must be exited 
07b0: 61 6e 20 65 71 75 61 6c 20 6e 75 6d 62 65 72 20  an equal number 
07c0: 6f 66 20 74 69 6d 65 73 20 62 65 66 6f 72 65 20  of times before 
07d0: 61 6e 6f 74 68 65 72 20 74 68 72 65 61 64 0a 2a  another thread.*
07e0: 2a 20 63 61 6e 20 65 6e 74 65 72 2e 20 20 49 66  * can enter.  If
07f0: 20 74 68 65 20 73 61 6d 65 20 74 68 72 65 61 64   the same thread
0800: 20 74 72 69 65 73 20 74 6f 20 65 6e 74 65 72 20   tries to enter 
0810: 61 6e 79 20 6f 74 68 65 72 20 6b 69 6e 64 20 6f  any other kind o
0820: 66 20 6d 75 74 65 78 0a 2a 2a 20 6d 6f 72 65 20  f mutex.** more 
0830: 74 68 61 6e 20 6f 6e 63 65 2c 20 74 68 65 20 62  than once, the b
0840: 65 68 61 76 69 6f 72 20 69 73 20 75 6e 64 65 66  ehavior is undef
0850: 69 6e 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  ined..*/.void sq
0860: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
0870: 72 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20  r(sqlite3_mutex 
0880: 2a 70 4e 6f 74 55 73 65 64 29 7b 7d 0a 69 6e 74  *pNotUsed){}.int
0890: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 74   sqlite3_mutex_t
08a0: 72 79 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  ry(sqlite3_mutex
08b0: 20 2a 70 4e 6f 74 55 73 65 64 29 7b 20 72 65 74   *pNotUsed){ ret
08c0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 7d  urn SQLITE_OK; }
08d0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 71 6c 69  ../*.** The sqli
08e0: 74 65 33 5f 6d 75 74 65 78 5f 65 78 69 74 28 29  te3_mutex_exit()
08f0: 20 72 6f 75 74 69 6e 65 20 65 78 69 74 73 20 61   routine exits a
0900: 20 6d 75 74 65 78 20 74 68 61 74 20 77 61 73 0a   mutex that was.
0910: 2a 2a 20 70 72 65 76 69 6f 75 73 6c 79 20 65 6e  ** previously en
0920: 74 65 72 65 64 20 62 79 20 74 68 65 20 73 61 6d  tered by the sam
0930: 65 20 74 68 72 65 61 64 2e 20 20 54 68 65 20 62  e thread.  The b
0940: 65 68 61 76 69 6f 72 0a 2a 2a 20 69 73 20 75 6e  ehavior.** is un
0950: 64 65 66 69 6e 65 64 20 69 66 20 74 68 65 20 6d  defined if the m
0960: 75 74 65 78 20 69 73 20 6e 6f 74 20 63 75 72 72  utex is not curr
0970: 65 6e 74 6c 79 20 65 6e 74 65 72 65 64 20 6f 72  ently entered or
0980: 0a 2a 2a 20 69 73 20 6e 6f 74 20 63 75 72 72 65  .** is not curre
0990: 6e 74 6c 79 20 61 6c 6c 6f 63 61 74 65 64 2e 20  ntly allocated. 
09a0: 20 53 51 4c 69 74 65 20 77 69 6c 6c 20 6e 65 76   SQLite will nev
09b0: 65 72 20 64 6f 20 65 69 74 68 65 72 2e 0a 2a 2f  er do either..*/
09c0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 6d 75  .void sqlite3_mu
09d0: 74 65 78 5f 6c 65 61 76 65 28 73 71 6c 69 74 65  tex_leave(sqlite
09e0: 33 5f 6d 75 74 65 78 20 2a 70 4e 6f 74 55 73 65  3_mutex *pNotUse
09f0: 64 29 7b 7d 0a 0a 23 69 66 20 30 0a 2f 2a 2a 2a  d){}..#if 0./***
0a00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 4e 6f  ************* No
0a10: 6e 2d 72 65 63 75 72 73 69 76 65 20 50 74 68 72  n-recursive Pthr
0a20: 65 61 64 20 4d 75 74 65 78 20 49 6d 70 6c 65 6d  ead Mutex Implem
0a30: 65 6e 74 61 74 69 6f 6e 20 2a 2a 2a 2a 2a 2a 2a  entation *******
0a40: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a  **********.**.**
0a50: 20 54 68 69 73 20 69 6d 70 6c 65 6d 65 6e 74 61   This implementa
0a60: 74 69 6f 6e 20 6f 66 20 6d 75 74 65 78 65 73 20  tion of mutexes 
0a70: 69 73 20 62 75 69 6c 74 20 75 73 69 6e 67 20 61  is built using a
0a80: 20 76 65 72 73 69 6f 6e 20 6f 66 20 70 74 68 72   version of pthr
0a90: 65 61 64 73 20 74 68 61 74 0a 2a 2a 20 64 6f 65  eads that.** doe
0aa0: 73 20 6e 6f 74 20 68 61 76 65 20 6e 61 74 69 76  s not have nativ
0ab0: 65 20 73 75 70 70 6f 72 74 20 66 6f 72 20 72 65  e support for re
0ac0: 63 75 72 73 69 76 65 20 6d 75 74 65 78 65 73 2e  cursive mutexes.
0ad0: 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20  .*/../*.** Each 
0ae0: 72 65 63 75 72 73 69 76 65 20 6d 75 74 65 78 20  recursive mutex 
0af0: 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f  is an instance o
0b00: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  f the following 
0b10: 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74  structure..*/.st
0b20: 72 75 63 74 20 52 4d 75 74 65 78 20 7b 0a 20 20  ruct RMutex {.  
0b30: 69 6e 74 20 72 65 63 75 72 73 69 76 65 4d 61 67  int recursiveMag
0b40: 69 63 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4d  ic;         /* M
0b50: 61 67 69 63 20 6e 75 6d 62 65 72 20 69 64 65 6e  agic number iden
0b60: 74 69 66 79 69 6e 67 20 74 68 69 73 20 61 73 20  tifying this as 
0b70: 72 65 63 75 72 73 69 76 65 20 2a 2f 0a 20 20 69  recursive */.  i
0b80: 6e 74 20 6e 52 65 66 3b 20 20 20 20 20 20 20 20  nt nRef;        
0b90: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
0ba0: 6d 62 65 72 20 6f 66 20 65 6e 74 72 61 6e 63 65  mber of entrance
0bb0: 73 20 2a 2f 0a 20 20 70 74 68 72 65 61 64 5f 6d  s */.  pthread_m
0bc0: 75 74 65 78 5f 74 20 61 75 78 4d 75 74 65 78 3b  utex_t auxMutex;
0bd0: 20 20 20 2f 2a 20 4d 75 74 65 78 20 63 6f 6e 74     /* Mutex cont
0be0: 72 6f 6c 6c 69 6e 67 20 61 63 63 65 73 73 20 74  rolling access t
0bf0: 6f 20 6e 52 65 66 20 61 6e 64 20 6f 77 6e 65 72  o nRef and owner
0c00: 20 2a 2f 0a 20 20 70 74 68 72 65 61 64 5f 6d 75   */.  pthread_mu
0c10: 74 65 78 5f 74 20 6d 61 69 6e 4d 75 74 65 78 3b  tex_t mainMutex;
0c20: 20 20 2f 2a 20 4d 75 74 65 78 20 63 6f 6e 74 72    /* Mutex contr
0c30: 6f 6c 6c 69 6e 67 20 74 68 65 20 6c 6f 63 6b 20  olling the lock 
0c40: 2a 2f 0a 20 20 70 74 68 72 65 61 64 5f 74 20 6f  */.  pthread_t o
0c50: 77 6e 65 72 3b 20 20 20 20 20 20 20 20 20 20 20  wner;           
0c60: 20 2f 2a 20 54 68 72 65 61 64 20 74 68 61 74 20   /* Thread that 
0c70: 69 73 20 77 69 74 68 69 6e 20 74 68 69 73 20 6d  is within this m
0c80: 75 74 65 78 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a  utex */.};../*.*
0c90: 2a 20 45 61 63 68 20 66 61 73 74 20 6d 75 74 65  * Each fast mute
0ca0: 78 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65  x is an instance
0cb0: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e   of the followin
0cc0: 67 20 73 74 72 75 63 74 75 72 65 0a 2a 2f 0a 73  g structure.*/.s
0cd0: 74 72 75 63 74 20 46 4d 75 74 65 78 20 7b 0a 20  truct FMutex {. 
0ce0: 20 69 6e 74 20 66 61 73 74 4d 61 67 69 63 3b 20   int fastMagic; 
0cf0: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 64 65 6e           /* Iden
0d00: 74 69 66 69 65 73 20 74 68 69 73 20 61 73 20 61  tifies this as a
0d10: 20 66 61 73 74 20 6d 75 74 65 78 20 2a 2f 0a 20   fast mutex */. 
0d20: 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 74   pthread_mutex_t
0d30: 20 6d 75 74 65 78 3b 20 20 2f 2a 20 54 68 65 20   mutex;  /* The 
0d40: 61 63 74 75 61 6c 20 75 6e 64 65 72 6c 79 69 6e  actual underlyin
0d50: 67 20 6d 75 74 65 78 20 2a 2f 0a 7d 3b 0a 0a 2f  g mutex */.};../
0d60: 2a 0a 2a 2a 20 45 69 74 68 65 72 20 6f 66 20 74  *.** Either of t
0d70: 68 65 20 61 62 6f 76 65 0a 2a 2f 0a 75 6e 69 6f  he above.*/.unio
0d80: 6e 20 41 6e 79 4d 75 74 65 78 20 7b 0a 20 20 73  n AnyMutex {.  s
0d90: 74 72 75 63 74 20 52 4d 75 74 65 78 20 72 3b 0a  truct RMutex r;.
0da0: 20 20 73 74 72 75 63 74 20 46 4d 75 74 65 78 20    struct FMutex 
0db0: 66 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 4d 61 67  f;.};../*.** Mag
0dc0: 69 63 20 6e 75 6d 62 65 72 73 0a 2a 2f 0a 23 64  ic numbers.*/.#d
0dd0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 54 58  efine SQLITE_MTX
0de0: 5f 52 45 43 55 52 53 49 56 45 20 20 20 30 78 34  _RECURSIVE   0x4
0df0: 45 44 38 38 36 45 44 0a 23 64 65 66 69 6e 65 20  ED886ED.#define 
0e00: 53 51 4c 49 54 45 5f 4d 54 58 5f 53 54 41 54 49  SQLITE_MTX_STATI
0e10: 43 20 20 20 20 20 20 30 78 35 36 46 43 45 31 42  C      0x56FCE1B
0e20: 34 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45  4.#define SQLITE
0e30: 5f 4d 54 58 5f 46 41 53 54 20 20 20 20 20 20 20  _MTX_FAST       
0e40: 20 30 78 32 34 35 42 46 44 34 46 0a 0a 2f 2a 0a   0x245BFD4F../*.
0e50: 2a 2a 20 53 74 61 74 69 63 20 6d 75 74 65 78 65  ** Static mutexe
0e60: 73 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  s.*/../*.** The 
0e70: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c  sqlite3_mutex_al
0e80: 6c 6f 63 28 29 20 72 6f 75 74 69 6e 65 20 61 6c  loc() routine al
0e90: 6c 6f 63 61 74 65 73 20 61 20 6e 65 77 0a 2a 2a  locates a new.**
0ea0: 20 6d 75 74 65 78 20 61 6e 64 20 72 65 74 75 72   mutex and retur
0eb0: 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  ns a pointer to 
0ec0: 69 74 2e 20 20 49 66 20 69 74 20 72 65 74 75 72  it.  If it retur
0ed0: 6e 73 20 4e 55 4c 4c 0a 2a 2a 20 74 68 61 74 20  ns NULL.** that 
0ee0: 6d 65 61 6e 73 20 74 68 61 74 20 61 20 6d 75 74  means that a mut
0ef0: 65 78 20 63 6f 75 6c 64 20 6e 6f 74 20 62 65 20  ex could not be 
0f00: 61 6c 6c 6f 63 61 74 65 64 2e 20 20 53 51 4c 69  allocated.  SQLi
0f10: 74 65 0a 2a 2a 20 77 69 6c 6c 20 75 6e 77 69 6e  te.** will unwin
0f20: 64 20 69 74 73 20 73 74 61 63 6b 20 61 6e 64 20  d its stack and 
0f30: 72 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 2e  return an error.
0f40: 20 20 54 68 65 20 61 72 67 75 6d 65 6e 74 0a 2a    The argument.*
0f50: 2a 20 74 6f 20 73 71 6c 69 74 65 33 5f 6d 75 74  * to sqlite3_mut
0f60: 65 78 5f 61 6c 6c 6f 63 28 29 20 69 73 20 6f 6e  ex_alloc() is on
0f70: 65 20 6f 66 20 74 68 65 73 65 20 69 6e 74 65 67  e of these integ
0f80: 65 72 20 63 6f 6e 73 74 61 6e 74 73 3a 0a 2a 2a  er constants:.**
0f90: 0a 2a 2a 20 3c 75 6c 3e 0a 2a 2a 20 3c 6c 69 3e  .** <ul>.** <li>
0fa0: 20 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 46    SQLITE_MUTEX_F
0fb0: 41 53 54 20 20 20 20 20 20 20 20 20 20 20 20 20  AST             
0fc0: 20 20 30 0a 2a 2a 20 3c 6c 69 3e 20 20 53 51 4c    0.** <li>  SQL
0fd0: 49 54 45 5f 4d 55 54 45 58 5f 52 45 43 55 52 53  ITE_MUTEX_RECURS
0fe0: 49 56 45 20 20 20 20 20 20 20 20 20 20 31 0a 2a  IVE          1.*
0ff0: 2a 20 3c 6c 69 3e 20 20 53 51 4c 49 54 45 5f 4d  * <li>  SQLITE_M
1000: 55 54 45 58 5f 53 54 41 54 49 43 5f 4d 41 53 54  UTEX_STATIC_MAST
1010: 45 52 20 20 20 20 20 20 32 0a 2a 2a 20 3c 6c 69  ER      2.** <li
1020: 3e 20 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f  >  SQLITE_MUTEX_
1030: 53 54 41 54 49 43 5f 4d 45 4d 20 20 20 20 20 20  STATIC_MEM      
1040: 20 20 20 33 0a 2a 2a 20 3c 6c 69 3e 20 20 53 51     3.** <li>  SQ
1050: 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49  LITE_MUTEX_STATI
1060: 43 5f 50 52 4e 47 20 20 20 20 20 20 20 20 34 0a  C_PRNG        4.
1070: 2a 2a 20 3c 2f 75 6c 3e 0a 2a 2a 0a 2a 2a 20 54  ** </ul>.**.** T
1080: 68 65 20 66 69 72 73 74 20 74 77 6f 20 63 6f 6e  he first two con
1090: 73 74 61 6e 74 73 20 63 61 75 73 65 20 73 71 6c  stants cause sql
10a0: 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63  ite3_mutex_alloc
10b0: 28 29 20 74 6f 20 63 72 65 61 74 65 0a 2a 2a 20  () to create.** 
10c0: 61 20 6e 65 77 20 6d 75 74 65 78 2e 20 20 54 68  a new mutex.  Th
10d0: 65 20 6e 65 77 20 6d 75 74 65 78 20 69 73 20 72  e new mutex is r
10e0: 65 63 75 72 73 69 76 65 20 77 68 65 6e 20 53 51  ecursive when SQ
10f0: 4c 49 54 45 5f 4d 55 54 45 58 5f 52 45 43 55 52  LITE_MUTEX_RECUR
1100: 53 49 56 45 0a 2a 2a 20 69 73 20 75 73 65 64 20  SIVE.** is used 
1110: 62 75 74 20 6e 6f 74 20 6e 65 63 65 73 73 61 72  but not necessar
1120: 69 6c 79 20 73 6f 20 77 68 65 6e 20 53 51 4c 49  ily so when SQLI
1130: 54 45 5f 4d 55 54 45 58 5f 46 41 53 54 20 69 73  TE_MUTEX_FAST is
1140: 20 75 73 65 64 2e 0a 2a 2a 20 54 68 65 20 6d 75   used..** The mu
1150: 74 65 78 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  tex implementati
1160: 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 6e 65 65 64  on does not need
1170: 20 74 6f 20 6d 61 6b 65 20 61 20 64 69 73 74 69   to make a disti
1180: 6e 63 74 69 6f 6e 0a 2a 2a 20 62 65 74 77 65 65  nction.** betwee
1190: 6e 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 52  n SQLITE_MUTEX_R
11a0: 45 43 55 52 53 49 56 45 20 61 6e 64 20 53 51 4c  ECURSIVE and SQL
11b0: 49 54 45 5f 4d 55 54 45 58 5f 46 41 53 54 20 69  ITE_MUTEX_FAST i
11c0: 66 20 69 74 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74  f it does.** not
11d0: 20 77 61 6e 74 20 74 6f 2e 20 20 42 75 74 20 53   want to.  But S
11e0: 51 4c 69 74 65 20 77 69 6c 6c 20 6f 6e 6c 79 20  QLite will only 
11f0: 72 65 71 75 65 73 74 20 61 20 72 65 63 75 72 73  request a recurs
1200: 69 76 65 20 6d 75 74 65 78 20 69 6e 0a 2a 2a 20  ive mutex in.** 
1210: 63 61 73 65 73 20 77 68 65 72 65 20 69 74 20 72  cases where it r
1220: 65 61 6c 6c 79 20 6e 65 65 64 73 20 6f 6e 65 2e  eally needs one.
1230: 20 20 49 66 20 61 20 66 61 73 74 65 72 20 6e 6f    If a faster no
1240: 6e 2d 72 65 63 75 72 73 69 76 65 20 6d 75 74 65  n-recursive mute
1250: 78 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 74  x.** implementat
1260: 69 6f 6e 20 69 73 20 61 76 61 69 6c 61 62 6c 65  ion is available
1270: 20 6f 6e 20 74 68 65 20 68 6f 73 74 20 70 6c 61   on the host pla
1280: 74 66 6f 72 6d 2c 20 74 68 65 20 6d 75 74 65 78  tform, the mutex
1290: 20 73 75 62 73 79 73 74 65 6d 0a 2a 2a 20 6d 69   subsystem.** mi
12a0: 67 68 74 20 72 65 74 75 72 6e 20 73 75 63 68 20  ght return such 
12b0: 61 20 6d 75 74 65 78 20 69 6e 20 72 65 73 70 6f  a mutex in respo
12c0: 6e 73 65 20 74 6f 20 53 51 4c 49 54 45 5f 4d 55  nse to SQLITE_MU
12d0: 54 45 58 5f 46 41 53 54 2e 0a 2a 2a 0a 2a 2a 20  TEX_FAST..**.** 
12e0: 54 68 65 20 6f 74 68 65 72 20 61 6c 6c 6f 77 65  The other allowe
12f0: 64 20 70 61 72 61 6d 65 74 65 72 73 20 74 6f 20  d parameters to 
1300: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c  sqlite3_mutex_al
1310: 6c 6f 63 28 29 20 65 61 63 68 20 72 65 74 75 72  loc() each retur
1320: 6e 0a 2a 2a 20 61 20 70 6f 69 6e 74 65 72 20 74  n.** a pointer t
1330: 6f 20 61 20 73 74 61 74 69 63 20 70 72 65 65 78  o a static preex
1340: 69 73 74 69 6e 67 20 6d 75 74 65 78 2e 20 20 54  isting mutex.  T
1350: 68 72 65 65 20 73 74 61 74 69 63 20 6d 75 74 65  hree static mute
1360: 78 65 73 20 61 72 65 0a 2a 2a 20 75 73 65 64 20  xes are.** used 
1370: 62 79 20 74 68 65 20 63 75 72 72 65 6e 74 20 76  by the current v
1380: 65 72 73 69 6f 6e 20 6f 66 20 53 51 4c 69 74 65  ersion of SQLite
1390: 2e 20 20 46 75 74 75 72 65 20 76 65 72 73 69 6f  .  Future versio
13a0: 6e 73 20 6f 66 20 53 51 4c 69 74 65 0a 2a 2a 20  ns of SQLite.** 
13b0: 6d 61 79 20 61 64 64 20 61 64 64 69 74 69 6f 6e  may add addition
13c0: 61 6c 20 73 74 61 74 69 63 20 6d 75 74 65 78 65  al static mutexe
13d0: 73 2e 20 20 53 74 61 74 69 63 20 6d 75 74 65 78  s.  Static mutex
13e0: 65 73 20 61 72 65 20 66 6f 72 20 69 6e 74 65 72  es are for inter
13f0: 6e 61 6c 0a 2a 2a 20 75 73 65 20 62 79 20 53 51  nal.** use by SQ
1400: 4c 69 74 65 20 6f 6e 6c 79 2e 20 20 41 70 70 6c  Lite only.  Appl
1410: 69 63 61 74 69 6f 6e 73 20 74 68 61 74 20 75 73  ications that us
1420: 65 20 53 51 4c 69 74 65 20 6d 75 74 65 78 65 73  e SQLite mutexes
1430: 20 73 68 6f 75 6c 64 0a 2a 2a 20 75 73 65 20 6f   should.** use o
1440: 6e 6c 79 20 74 68 65 20 64 79 6e 61 6d 69 63 20  nly the dynamic 
1450: 6d 75 74 65 78 65 73 20 72 65 74 75 72 6e 65 64  mutexes returned
1460: 20 62 79 20 53 51 4c 49 54 45 5f 4d 55 54 45 58   by SQLITE_MUTEX
1470: 5f 46 41 53 54 20 6f 72 0a 2a 2a 20 53 51 4c 49  _FAST or.** SQLI
1480: 54 45 5f 4d 55 54 45 58 5f 52 45 43 55 52 53 49  TE_MUTEX_RECURSI
1490: 56 45 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74  VE..**.** Note t
14a0: 68 61 74 20 69 66 20 6f 6e 65 20 6f 66 20 74 68  hat if one of th
14b0: 65 20 64 79 6e 61 6d 69 63 20 6d 75 74 65 78 20  e dynamic mutex 
14c0: 70 61 72 61 6d 65 74 65 72 73 20 28 53 51 4c 49  parameters (SQLI
14d0: 54 45 5f 4d 55 54 45 58 5f 46 41 53 54 0a 2a 2a  TE_MUTEX_FAST.**
14e0: 20 6f 72 20 53 51 4c 49 54 45 5f 4d 55 54 45 58   or SQLITE_MUTEX
14f0: 5f 52 45 43 55 52 53 49 56 45 29 20 69 73 20 75  _RECURSIVE) is u
1500: 73 65 64 20 74 68 65 6e 20 73 71 6c 69 74 65 33  sed then sqlite3
1510: 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 29 0a 2a  _mutex_alloc().*
1520: 2a 20 72 65 74 75 72 6e 73 20 61 20 64 69 66 66  * returns a diff
1530: 65 72 65 6e 74 20 6d 75 74 65 78 20 6f 6e 20 65  erent mutex on e
1540: 76 65 72 79 20 63 61 6c 6c 2e 20 20 42 75 74 20  very call.  But 
1550: 66 6f 72 20 74 68 65 20 73 74 61 74 69 63 20 0a  for the static .
1560: 2a 2a 20 6d 75 74 65 78 20 74 79 70 65 73 2c 20  ** mutex types, 
1570: 74 68 65 20 73 61 6d 65 20 6d 75 74 65 78 20 69  the same mutex i
1580: 73 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 65 76  s returned on ev
1590: 65 72 79 20 63 61 6c 6c 20 74 68 61 74 20 68 61  ery call that ha
15a0: 73 0a 2a 2a 20 74 68 65 20 73 61 6d 65 20 74 79  s.** the same ty
15b0: 70 65 20 6e 75 6d 62 65 72 2e 0a 2a 2f 0a 73 71  pe number..*/.sq
15c0: 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c  lite3_mutex *sql
15d0: 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63  ite3_mutex_alloc
15e0: 28 69 6e 74 20 69 54 79 70 65 29 7b 0a 20 20 73  (int iType){.  s
15f0: 74 61 74 69 63 20 73 74 72 75 63 74 20 46 4d 75  tatic struct FMu
1600: 74 65 78 20 73 74 61 74 69 63 4d 75 74 65 78 65  tex staticMutexe
1610: 73 5b 5d 20 3d 20 7b 0a 20 20 20 20 7b 20 53 51  s[] = {.    { SQ
1620: 4c 49 54 45 5f 4d 54 58 5f 53 54 41 54 49 43 2c  LITE_MTX_STATIC,
1630: 20 50 54 48 52 45 41 44 5f 4d 55 54 45 58 5f 49   PTHREAD_MUTEX_I
1640: 4e 49 54 49 41 4c 49 5a 45 52 20 7d 2c 0a 20 20  NITIALIZER },.  
1650: 20 20 7b 20 53 51 4c 49 54 45 5f 4d 54 58 5f 53    { SQLITE_MTX_S
1660: 54 41 54 49 43 2c 20 50 54 48 52 45 41 44 5f 4d  TATIC, PTHREAD_M
1670: 55 54 45 58 5f 49 4e 49 54 49 41 4c 49 5a 45 52  UTEX_INITIALIZER
1680: 20 7d 2c 0a 20 20 20 20 7b 20 53 51 4c 49 54 45   },.    { SQLITE
1690: 5f 4d 54 58 5f 53 54 41 54 49 43 2c 20 50 54 48  _MTX_STATIC, PTH
16a0: 52 45 41 44 5f 4d 55 54 45 58 5f 49 4e 49 54 49  READ_MUTEX_INITI
16b0: 41 4c 49 5a 45 52 20 7d 2c 0a 20 20 7d 3b 0a 20  ALIZER },.  };. 
16c0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a   sqlite3_mutex *
16d0: 70 3b 0a 20 20 73 77 69 74 63 68 28 20 69 54 79  p;.  switch( iTy
16e0: 70 65 20 29 7b 0a 20 20 20 20 63 61 73 65 20 53  pe ){.    case S
16f0: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 46 41 53 54  QLITE_MUTEX_FAST
1700: 3a 20 7b 0a 20 20 20 20 20 20 73 74 72 75 63 74  : {.      struct
1710: 20 46 4d 75 74 65 78 20 2a 70 78 20 3d 20 73 71   FMutex *px = sq
1720: 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20 73 69  lite3_malloc( si
1730: 7a 65 6f 66 28 2a 70 78 29 20 29 3b 0a 20 20 20  zeof(*px) );.   
1740: 20 20 20 69 66 28 20 70 78 20 29 7b 0a 20 20 20     if( px ){.   
1750: 20 20 20 20 20 70 78 2d 3e 66 61 73 74 4d 61 67       px->fastMag
1760: 69 63 20 3d 20 53 51 4c 49 54 45 5f 4d 54 58 5f  ic = SQLITE_MTX_
1770: 46 41 53 54 3b 0a 20 20 20 20 20 20 20 20 70 74  FAST;.        pt
1780: 68 72 65 61 64 5f 6d 75 74 65 78 5f 69 6e 69 74  hread_mutex_init
1790: 28 26 70 78 2d 3e 6d 75 74 65 78 2c 20 30 29 3b  (&px->mutex, 0);
17a0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70  .      }.      p
17b0: 20 3d 20 28 73 71 6c 69 74 65 33 5f 6d 75 74 65   = (sqlite3_mute
17c0: 78 2a 29 70 78 3b 0a 20 20 20 20 20 20 62 72 65  x*)px;.      bre
17d0: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61  ak;.    }.    ca
17e0: 73 65 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f  se SQLITE_MUTEX_
17f0: 52 45 43 55 52 53 49 56 45 3a 20 7b 0a 20 20 20  RECURSIVE: {.   
1800: 20 20 20 73 74 72 75 63 74 20 52 4d 75 74 65 78     struct RMutex
1810: 20 2a 70 78 20 3d 20 73 71 6c 69 74 65 33 5f 6d   *px = sqlite3_m
1820: 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 2a 70  alloc( sizeof(*p
1830: 78 29 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20  x) );.      if( 
1840: 70 78 20 29 7b 0a 20 20 20 20 20 20 20 20 70 78  px ){.        px
1850: 2d 3e 72 65 63 75 72 73 69 76 65 4d 61 67 69 63  ->recursiveMagic
1860: 20 3d 20 53 51 4c 49 54 45 5f 4d 54 58 5f 52 45   = SQLITE_MTX_RE
1870: 43 55 52 53 49 56 45 3b 0a 20 20 20 20 20 20 20  CURSIVE;.       
1880: 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 69   pthread_mutex_i
1890: 6e 69 74 28 26 70 78 2d 3e 61 75 78 4d 75 74 65  nit(&px->auxMute
18a0: 78 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 70  x, 0);.        p
18b0: 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 69 6e 69  thread_mutex_ini
18c0: 74 28 26 70 78 2d 3e 6d 61 69 6e 4d 75 74 65 78  t(&px->mainMutex
18d0: 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 70 78  , 0);.        px
18e0: 2d 3e 6e 52 65 66 20 3d 20 30 3b 0a 20 20 20 20  ->nRef = 0;.    
18f0: 20 20 7d 0a 20 20 20 20 20 20 70 20 3d 20 28 73    }.      p = (s
1900: 71 6c 69 74 65 33 5f 6d 75 74 65 78 2a 29 70 78  qlite3_mutex*)px
1910: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  ;.      break;. 
1920: 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74     }.    default
1930: 3a 20 7b 0a 20 20 20 20 20 20 70 20 3d 20 26 73  : {.      p = &s
1940: 74 61 74 69 63 4d 75 74 65 78 65 73 5b 69 54 79  taticMutexes[iTy
1950: 70 65 2d 32 5d 3b 0a 20 20 20 20 20 20 62 72 65  pe-2];.      bre
1960: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  ak;.    }.  }.  
1970: 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 0a 2f 2a  return p;.}.../*
1980: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
1990: 20 64 65 61 6c 6c 6f 63 61 74 65 73 20 61 20 70   deallocates a p
19a0: 72 65 76 69 6f 75 73 6c 79 0a 2a 2a 20 61 6c 6c  reviously.** all
19b0: 6f 63 61 74 65 64 20 6d 75 74 65 78 2e 20 20 53  ocated mutex.  S
19c0: 51 4c 69 74 65 20 69 73 20 63 61 72 65 66 75 6c  QLite is careful
19d0: 20 74 6f 20 64 65 61 6c 6c 6f 63 61 74 65 20 65   to deallocate e
19e0: 76 65 72 79 0a 2a 2a 20 6d 75 74 65 78 20 74 68  very.** mutex th
19f0: 61 74 20 69 74 20 61 6c 6c 6f 63 61 74 65 73 2e  at it allocates.
1a00: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
1a10: 5f 6d 75 74 65 78 5f 66 72 65 65 28 73 71 6c 69  _mutex_free(sqli
1a20: 74 65 33 5f 6d 75 74 65 78 20 2a 70 4d 75 74 65  te3_mutex *pMute
1a30: 78 29 7b 0a 20 20 69 6e 74 20 69 54 79 70 65 20  x){.  int iType 
1a40: 3d 20 2a 28 69 6e 74 2a 29 70 4d 75 74 65 78 3b  = *(int*)pMutex;
1a50: 0a 20 20 69 66 28 20 69 54 79 70 65 3d 3d 53 51  .  if( iType==SQ
1a60: 4c 49 54 45 5f 4d 54 58 5f 46 41 53 54 20 29 7b  LITE_MTX_FAST ){
1a70: 0a 20 20 20 20 73 74 72 75 63 74 20 46 4d 75 74  .    struct FMut
1a80: 65 78 20 2a 70 20 3d 20 28 73 74 72 75 63 74 20  ex *p = (struct 
1a90: 46 4d 75 74 65 78 2a 29 70 4d 75 74 65 78 3b 0a  FMutex*)pMutex;.
1aa0: 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65      pthread_mute
1ab0: 78 5f 64 65 73 74 72 6f 79 28 26 70 2d 3e 6d 75  x_destroy(&p->mu
1ac0: 74 65 78 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  tex);.    sqlite
1ad0: 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 65 6c  3_free(p);.  }el
1ae0: 73 65 20 69 66 28 20 69 54 79 70 65 3d 3d 53 51  se if( iType==SQ
1af0: 4c 49 54 45 5f 4d 54 58 5f 52 45 43 55 52 53 49  LITE_MTX_RECURSI
1b00: 56 45 20 29 7b 0a 20 20 20 20 73 74 72 75 63 74  VE ){.    struct
1b10: 20 52 4d 75 74 65 78 20 2a 70 20 3d 20 28 73 74   RMutex *p = (st
1b20: 72 75 63 74 20 52 4d 75 74 65 78 2a 29 70 4d 75  ruct RMutex*)pMu
1b30: 74 65 78 3b 0a 20 20 20 20 70 74 68 72 65 61 64  tex;.    pthread
1b40: 5f 6d 75 74 65 78 5f 64 65 73 74 72 6f 79 28 26  _mutex_destroy(&
1b50: 70 2d 3e 61 75 78 4d 75 74 65 78 29 3b 0a 20 20  p->auxMutex);.  
1b60: 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f    pthread_mutex_
1b70: 64 65 73 74 72 6f 79 28 26 70 2d 3e 6d 61 69 6e  destroy(&p->main
1b80: 4d 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c 69  Mutex);.    sqli
1b90: 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d  te3_free(p);.  }
1ba0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 71  .}../*.** The sq
1bb0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
1bc0: 72 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f  r() and sqlite3_
1bd0: 6d 75 74 65 78 5f 74 72 79 28 29 20 72 6f 75 74  mutex_try() rout
1be0: 69 6e 65 73 20 61 74 74 65 6d 70 74 0a 2a 2a 20  ines attempt.** 
1bf0: 74 6f 20 65 6e 74 65 72 20 61 20 6d 75 74 65 78  to enter a mutex
1c00: 2e 20 20 49 66 20 61 6e 6f 74 68 65 72 20 74 68  .  If another th
1c10: 72 65 61 64 20 69 73 20 61 6c 72 65 61 64 79 20  read is already 
1c20: 77 69 74 68 69 6e 20 74 68 65 20 6d 75 74 65 78  within the mutex
1c30: 2c 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6d 75 74  ,.** sqlite3_mut
1c40: 65 78 5f 65 6e 74 65 72 28 29 20 77 69 6c 6c 20  ex_enter() will 
1c50: 62 6c 6f 63 6b 20 61 6e 64 20 73 71 6c 69 74 65  block and sqlite
1c60: 33 5f 6d 75 74 65 78 5f 74 72 79 28 29 20 77 69  3_mutex_try() wi
1c70: 6c 6c 20 72 65 74 75 72 6e 0a 2a 2a 20 53 51 4c  ll return.** SQL
1c80: 49 54 45 5f 42 55 53 59 2e 20 20 54 68 65 20 73  ITE_BUSY.  The s
1c90: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 74 72 79  qlite3_mutex_try
1ca0: 28 29 20 69 6e 74 65 72 66 61 63 65 20 72 65 74  () interface ret
1cb0: 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a  urns SQLITE_OK.*
1cc0: 2a 20 75 70 6f 6e 20 73 75 63 63 65 73 73 66 75  * upon successfu
1cd0: 6c 20 65 6e 74 72 79 2e 20 20 4d 75 74 65 78 65  l entry.  Mutexe
1ce0: 73 20 63 72 65 61 74 65 64 20 75 73 69 6e 67 20  s created using 
1cf0: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 52 45 43  SQLITE_MUTEX_REC
1d00: 55 52 53 49 56 45 20 63 61 6e 0a 2a 2a 20 62 65  URSIVE can.** be
1d10: 20 65 6e 74 65 72 65 64 20 6d 75 6c 74 69 70 6c   entered multipl
1d20: 65 20 74 69 6d 65 73 20 62 79 20 74 68 65 20 73  e times by the s
1d30: 61 6d 65 20 74 68 72 65 61 64 2e 20 20 49 6e 20  ame thread.  In 
1d40: 73 75 63 68 20 63 61 73 65 73 20 74 68 65 2c 0a  such cases the,.
1d50: 2a 2a 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65  ** mutex must be
1d60: 20 65 78 69 74 65 64 20 61 6e 20 65 71 75 61 6c   exited an equal
1d70: 20 6e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 73   number of times
1d80: 20 62 65 66 6f 72 65 20 61 6e 6f 74 68 65 72 20   before another 
1d90: 74 68 72 65 61 64 0a 2a 2a 20 63 61 6e 20 65 6e  thread.** can en
1da0: 74 65 72 2e 20 20 49 66 20 74 68 65 20 73 61 6d  ter.  If the sam
1db0: 65 20 74 68 72 65 61 64 20 74 72 69 65 73 20 74  e thread tries t
1dc0: 6f 20 65 6e 74 65 72 20 61 6e 79 20 6f 74 68 65  o enter any othe
1dd0: 72 20 6b 69 6e 64 20 6f 66 20 6d 75 74 65 78 0a  r kind of mutex.
1de0: 2a 2a 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 63  ** more than onc
1df0: 65 2c 20 74 68 65 20 62 65 68 61 76 69 6f 72 20  e, the behavior 
1e00: 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2f  is undefined..*/
1e10: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 6d 75  .void sqlite3_mu
1e20: 74 65 78 5f 65 6e 74 65 72 28 73 71 6c 69 74 65  tex_enter(sqlite
1e30: 33 5f 6d 75 74 65 78 20 2a 70 4d 75 74 65 78 29  3_mutex *pMutex)
1e40: 7b 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4d  {.  if( SQLITE_M
1e50: 54 58 5f 46 41 53 54 20 3d 3d 20 2a 28 69 6e 74  TX_FAST == *(int
1e60: 2a 29 70 4d 75 74 65 78 20 29 7b 0a 20 20 20 20  *)pMutex ){.    
1e70: 73 74 72 75 63 74 20 46 4d 75 74 65 78 20 2a 70  struct FMutex *p
1e80: 20 3d 20 28 73 74 72 75 63 74 20 46 4d 75 74 65   = (struct FMute
1e90: 78 2a 29 70 4d 75 74 65 78 3b 0a 20 20 20 20 70  x*)pMutex;.    p
1ea0: 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 6c 6f 63  thread_mutex_loc
1eb0: 6b 28 26 70 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  k(&p->mutex);.  
1ec0: 7d 65 6c 73 65 7b 0a 20 20 20 20 73 74 72 75 63  }else{.    struc
1ed0: 74 20 52 4d 75 74 65 78 20 2a 70 20 3d 20 28 73  t RMutex *p = (s
1ee0: 74 72 75 63 74 20 52 4d 75 74 65 78 2a 29 70 4d  truct RMutex*)pM
1ef0: 75 74 65 78 3b 0a 20 20 20 20 77 68 69 6c 65 28  utex;.    while(
1f00: 31 29 7b 0a 20 20 20 20 20 20 70 74 68 72 65 61  1){.      pthrea
1f10: 64 5f 6d 75 74 65 78 5f 6c 6f 63 6b 28 26 70 2d  d_mutex_lock(&p-
1f20: 3e 61 75 78 4d 75 74 65 78 29 3b 0a 20 20 20 20  >auxMutex);.    
1f30: 20 20 69 66 28 20 70 2d 3e 6e 52 65 66 3d 3d 30    if( p->nRef==0
1f40: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e 6e   ){.        p->n
1f50: 52 65 66 2b 2b 3b 0a 20 20 20 20 20 20 20 20 70  Ref++;.        p
1f60: 2d 3e 6f 77 6e 65 72 20 3d 20 70 74 68 72 65 61  ->owner = pthrea
1f70: 64 5f 73 65 6c 66 28 29 3b 0a 20 20 20 20 20 20  d_self();.      
1f80: 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65 78 5f    pthread_mutex_
1f90: 6c 6f 63 6b 28 26 70 2d 3e 6d 61 69 6e 4d 75 74  lock(&p->mainMut
1fa0: 65 78 29 3b 0a 20 20 20 20 20 20 20 20 70 74 68  ex);.        pth
1fb0: 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f 63  read_mutex_unloc
1fc0: 6b 28 26 70 2d 3e 61 75 78 4d 75 74 65 78 29 3b  k(&p->auxMutex);
1fd0: 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  .        break;.
1fe0: 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20        }else if( 
1ff0: 70 74 68 72 65 61 64 5f 65 71 75 61 6c 28 70 2d  pthread_equal(p-
2000: 3e 6f 77 6e 65 72 2c 20 70 74 68 72 65 61 64 5f  >owner, pthread_
2010: 73 65 6c 66 28 29 29 20 29 7b 0a 20 20 20 20 20  self()) ){.     
2020: 20 20 20 70 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20     p->nRef++;.  
2030: 20 20 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75        pthread_mu
2040: 74 65 78 5f 75 6e 6c 6f 63 6b 28 26 70 2d 3e 61  tex_unlock(&p->a
2050: 75 78 4d 75 74 65 78 29 3b 0a 20 20 20 20 20 20  uxMutex);.      
2060: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d    break;.      }
2070: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 74  else{.        pt
2080: 68 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f  hread_mutex_unlo
2090: 63 6b 28 26 70 2d 3e 61 75 78 4d 75 74 65 78 29  ck(&p->auxMutex)
20a0: 3b 0a 20 20 20 20 20 20 20 20 70 74 68 72 65 61  ;.        pthrea
20b0: 64 5f 6d 75 74 65 78 5f 6c 6f 63 6b 28 26 70 2d  d_mutex_lock(&p-
20c0: 3e 6d 61 69 6e 4d 75 74 65 78 29 3b 0a 20 20 20  >mainMutex);.   
20d0: 20 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75 74       pthread_mut
20e0: 65 78 5f 75 6e 6c 6f 63 6b 28 26 70 2d 3e 6d 61  ex_unlock(&p->ma
20f0: 69 6e 4d 75 74 65 78 29 3b 0a 20 20 20 20 20 20  inMutex);.      
2100: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 69 6e  }.    }.  }.}.in
2110: 74 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  t sqlite3_mutex_
2120: 74 72 79 28 73 71 6c 69 74 65 33 5f 6d 75 74 65  try(sqlite3_mute
2130: 78 20 2a 70 4d 75 74 65 78 29 7b 0a 20 20 69 66  x *pMutex){.  if
2140: 28 20 53 51 4c 49 54 45 5f 4d 54 58 5f 46 41 53  ( SQLITE_MTX_FAS
2150: 54 20 3d 3d 20 2a 28 69 6e 74 2a 29 70 4d 75 74  T == *(int*)pMut
2160: 65 78 20 29 7b 0a 20 20 20 20 73 74 72 75 63 74  ex ){.    struct
2170: 20 46 4d 75 74 65 78 20 2a 70 20 3d 20 28 73 74   FMutex *p = (st
2180: 72 75 63 74 20 46 4d 75 74 65 78 2a 29 70 4d 75  ruct FMutex*)pMu
2190: 74 65 78 3b 0a 20 20 20 20 69 66 28 20 70 74 68  tex;.    if( pth
21a0: 72 65 61 64 5f 6d 75 74 65 78 5f 74 72 79 6c 6f  read_mutex_trylo
21b0: 63 6b 28 26 70 2d 3e 6d 75 74 65 78 29 20 29 7b  ck(&p->mutex) ){
21c0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51  .      return SQ
21d0: 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 7d  LITE_BUSY;.    }
21e0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 74  .  }else{.    st
21f0: 72 75 63 74 20 52 4d 75 74 65 78 20 2a 70 20 3d  ruct RMutex *p =
2200: 20 28 73 74 72 75 63 74 20 52 4d 75 74 65 78 2a   (struct RMutex*
2210: 29 70 4d 75 74 65 78 3b 0a 20 20 20 20 70 74 68  )pMutex;.    pth
2220: 72 65 61 64 5f 6d 75 74 65 78 5f 6c 6f 63 6b 28  read_mutex_lock(
2230: 26 70 2d 3e 61 75 78 4d 75 74 65 78 29 3b 0a 20  &p->auxMutex);. 
2240: 20 20 20 69 66 28 20 70 2d 3e 6e 52 65 66 3d 3d     if( p->nRef==
2250: 30 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 6e 52  0 ){.      p->nR
2260: 65 66 2b 2b 3b 0a 20 20 20 20 20 20 70 2d 3e 6f  ef++;.      p->o
2270: 77 6e 65 72 20 3d 20 70 74 68 72 65 61 64 5f 73  wner = pthread_s
2280: 65 6c 66 28 29 3b 0a 20 20 20 20 20 20 70 74 68  elf();.      pth
2290: 72 65 61 64 5f 6d 75 74 65 78 5f 6c 6f 63 6b 28  read_mutex_lock(
22a0: 26 70 2d 3e 6d 61 69 6e 4d 75 74 65 78 29 3b 0a  &p->mainMutex);.
22b0: 20 20 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75        pthread_mu
22c0: 74 65 78 5f 75 6e 6c 6f 63 6b 28 26 70 2d 3e 61  tex_unlock(&p->a
22d0: 75 78 4d 75 74 65 78 29 3b 0a 20 20 20 20 7d 65  uxMutex);.    }e
22e0: 6c 73 65 20 69 66 28 20 70 74 68 72 65 61 64 5f  lse if( pthread_
22f0: 65 71 75 61 6c 28 70 2d 3e 6f 77 6e 65 72 2c 20  equal(p->owner, 
2300: 70 74 68 72 65 61 64 5f 73 65 6c 66 28 29 29 20  pthread_self()) 
2310: 29 7b 0a 20 20 20 20 20 20 70 2d 3e 6e 52 65 66  ){.      p->nRef
2320: 2b 2b 3b 0a 20 20 20 20 20 20 70 74 68 72 65 61  ++;.      pthrea
2330: 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f 63 6b 28 26  d_mutex_unlock(&
2340: 70 2d 3e 61 75 78 4d 75 74 65 78 29 3b 0a 20 20  p->auxMutex);.  
2350: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70    }else{.      p
2360: 74 68 72 65 61 64 5f 6d 75 74 65 78 5f 75 6e 6c  thread_mutex_unl
2370: 6f 63 6b 28 26 70 2d 3e 61 75 78 4d 75 74 65 78  ock(&p->auxMutex
2380: 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  );.      return 
2390: 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20  SQLITE_BUSY;.   
23a0: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
23b0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
23c0: 0a 2a 2a 20 54 68 65 20 73 71 6c 69 74 65 33 5f  .** The sqlite3_
23d0: 6d 75 74 65 78 5f 65 78 69 74 28 29 20 72 6f 75  mutex_exit() rou
23e0: 74 69 6e 65 20 65 78 69 74 73 20 61 20 6d 75 74  tine exits a mut
23f0: 65 78 20 74 68 61 74 20 77 61 73 0a 2a 2a 20 70  ex that was.** p
2400: 72 65 76 69 6f 75 73 6c 79 20 65 6e 74 65 72 65  reviously entere
2410: 64 20 62 79 20 74 68 65 20 73 61 6d 65 20 74 68  d by the same th
2420: 72 65 61 64 2e 20 20 54 68 65 20 62 65 68 61 76  read.  The behav
2430: 69 6f 72 0a 2a 2a 20 69 73 20 75 6e 64 65 66 69  ior.** is undefi
2440: 6e 65 64 20 69 66 20 74 68 65 20 6d 75 74 65 78  ned if the mutex
2450: 20 69 73 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c   is not currentl
2460: 79 20 65 6e 74 65 72 65 64 20 6f 72 0a 2a 2a 20  y entered or.** 
2470: 69 73 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79  is not currently
2480: 20 61 6c 6c 6f 63 61 74 65 64 2e 20 20 53 51 4c   allocated.  SQL
2490: 69 74 65 20 77 69 6c 6c 20 6e 65 76 65 72 20 64  ite will never d
24a0: 6f 20 65 69 74 68 65 72 2e 0a 2a 2f 0a 76 6f 69  o either..*/.voi
24b0: 64 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  d sqlite3_mutex_
24c0: 6c 65 61 76 65 28 73 71 6c 69 74 65 33 5f 6d 75  leave(sqlite3_mu
24d0: 74 65 78 20 2a 70 4d 75 74 65 78 29 7b 0a 20 20  tex *pMutex){.  
24e0: 69 66 28 20 53 51 4c 49 54 45 5f 4d 54 58 5f 46  if( SQLITE_MTX_F
24f0: 41 53 54 20 3d 3d 20 2a 28 69 6e 74 2a 29 70 4d  AST == *(int*)pM
2500: 75 74 65 78 20 29 7b 0a 20 20 20 20 73 74 72 75  utex ){.    stru
2510: 63 74 20 46 4d 75 74 65 78 20 2a 70 20 3d 20 28  ct FMutex *p = (
2520: 73 74 72 75 63 74 20 46 4d 75 74 65 78 2a 29 70  struct FMutex*)p
2530: 4d 75 74 65 78 3b 0a 20 20 20 20 70 74 68 72 65  Mutex;.    pthre
2540: 61 64 5f 6d 75 74 65 78 5f 75 6e 6c 6f 63 6b 28  ad_mutex_unlock(
2550: 26 70 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 65  &p->mutex);.  }e
2560: 6c 73 65 7b 0a 20 20 20 20 73 74 72 75 63 74 20  lse{.    struct 
2570: 52 4d 75 74 65 78 20 2a 70 20 3d 20 28 73 74 72  RMutex *p = (str
2580: 75 63 74 20 52 4d 75 74 65 78 2a 29 70 4d 75 74  uct RMutex*)pMut
2590: 65 78 3b 0a 20 20 20 20 70 74 68 72 65 61 64 5f  ex;.    pthread_
25a0: 6d 75 74 65 78 5f 6c 6f 63 6b 28 26 70 2d 3e 61  mutex_lock(&p->a
25b0: 75 78 4d 75 74 65 78 29 3b 0a 20 20 20 20 70 2d  uxMutex);.    p-
25c0: 3e 6e 52 65 66 2d 2d 3b 0a 20 20 20 20 69 66 28  >nRef--;.    if(
25d0: 20 70 2d 3e 6e 52 65 66 3c 3d 30 20 29 7b 0a 20   p->nRef<=0 ){. 
25e0: 20 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75 74       pthread_mut
25f0: 65 78 5f 75 6e 6c 6f 63 6b 28 26 70 2d 3e 6d 61  ex_unlock(&p->ma
2600: 69 6e 4d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a  inMutex);.    }.
2610: 20 20 20 20 70 74 68 72 65 61 64 5f 6d 75 74 65      pthread_mute
2620: 78 5f 75 6e 6c 6f 63 6b 28 26 70 2d 3e 61 75 78  x_unlock(&p->aux
2630: 4d 75 74 65 78 29 3b 0a 20 20 7d 0a 7d 0a 23 65  Mutex);.  }.}.#e
2640: 6e 64 69 66 20 2f 2a 20 6e 6f 6e 2d 72 65 63 75  ndif /* non-recu
2650: 72 73 69 76 65 20 70 74 68 72 65 61 64 73 20 2a  rsive pthreads *
2660: 2f 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 21 64 65  /..#endif /* !de
2670: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d 55 54  fined(SQLITE_MUT
2680: 45 58 5f 41 50 50 44 45 46 29 20 2a 2f 0a        EX_APPDEF) */.