/ Hex Artifact Content
Login

Artifact d67ea9666d09b5b5049c955b3999cee31959d04e:


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: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c  ..**.** This fil
01c0: 65 20 63 6f 6e 74 61 69 6e 73 20 63 6f 64 65 20  e contains code 
01d0: 74 68 61 74 20 69 73 20 63 6f 6d 6d 6f 6e 20 61  that is common a
01e0: 63 72 6f 73 73 20 61 6c 6c 20 6d 75 74 65 78 20  cross all mutex 
01f0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 2e  implementations.
0200: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71  .*/.#include "sq
0210: 6c 69 74 65 49 6e 74 2e 68 22 0a 0a 23 69 66 20  liteInt.h"..#if 
0220: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44  defined(SQLITE_D
0230: 45 42 55 47 29 20 26 26 20 21 64 65 66 69 6e 65  EBUG) && !define
0240: 64 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 4f  d(SQLITE_MUTEX_O
0250: 4d 49 54 29 0a 2f 2a 0a 2a 2a 20 46 6f 72 20 64  MIT)./*.** For d
0260: 65 62 75 67 67 69 6e 67 20 70 75 72 70 6f 73 65  ebugging purpose
0270: 73 2c 20 72 65 63 6f 72 64 20 77 68 65 6e 20 74  s, record when t
0280: 68 65 20 6d 75 74 65 78 20 73 75 62 73 79 73 74  he mutex subsyst
0290: 65 6d 20 69 73 20 69 6e 69 74 69 61 6c 69 7a 65  em is initialize
02a0: 64 0a 2a 2a 20 61 6e 64 20 75 6e 69 6e 69 74 69  d.** and uniniti
02b0: 61 6c 69 7a 65 64 20 73 6f 20 74 68 61 74 20 77  alized so that w
02c0: 65 20 63 61 6e 20 61 73 73 65 72 74 28 29 20 69  e can assert() i
02d0: 66 20 74 68 65 72 65 20 69 73 20 61 6e 20 61 74  f there is an at
02e0: 74 65 6d 70 74 20 74 6f 0a 2a 2a 20 61 6c 6c 6f  tempt to.** allo
02f0: 63 61 74 65 20 61 20 6d 75 74 65 78 20 77 68 69  cate a mutex whi
0300: 6c 65 20 74 68 65 20 73 79 73 74 65 6d 20 69 73  le the system is
0310: 20 75 6e 69 6e 69 74 69 61 6c 69 7a 65 64 2e 0a   uninitialized..
0320: 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c 49 54 45  */.static SQLITE
0330: 5f 57 53 44 20 69 6e 74 20 6d 75 74 65 78 49 73  _WSD int mutexIs
0340: 49 6e 69 74 20 3d 20 30 3b 0a 23 65 6e 64 69 66  Init = 0;.#endif
0350: 20 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42 55 47   /* SQLITE_DEBUG
0360: 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 49 6d 70 6c 65   */../*.** Imple
0370: 6d 65 6e 74 61 74 69 6f 6e 73 20 63 61 6e 20 73  mentations can s
0380: 70 65 63 69 66 79 20 61 6e 20 61 6c 74 65 72 6e  pecify an altern
0390: 61 74 69 76 65 20 72 6f 75 74 69 6e 65 20 66 6f  ative routine fo
03a0: 72 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 0a 2a  r initializing.*
03b0: 2a 20 74 68 65 20 6d 75 74 65 78 20 75 73 69 6e  * the mutex usin
03c0: 67 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 55 54  g the SQLITE_MUT
03d0: 45 58 5f 44 45 46 41 55 4c 54 20 6d 61 63 72 6f  EX_DEFAULT macro
03e0: 2e 20 20 54 68 69 73 20 6d 61 63 72 6f 20 73 68  .  This macro sh
03f0: 6f 75 6c 64 0a 2a 2a 20 72 65 73 6f 6c 76 65 20  ould.** resolve 
0400: 74 6f 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e  to an expression
0410: 20 74 68 61 74 20 72 65 74 75 72 6e 73 20 61 20   that returns a 
0420: 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 0a 2a 2a  pointer to an.**
0430: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d   sqlite3_mutex_m
0440: 65 74 68 6f 64 73 20 6f 62 6a 65 63 74 20 74 68  ethods object th
0450: 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68  at implements th
0460: 65 20 64 65 66 61 75 6c 74 20 6d 75 74 65 78 2e  e default mutex.
0470: 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 6e 20 75  .** This is an u
0480: 6e 64 6f 63 75 6d 65 6e 74 65 64 20 66 65 61 74  ndocumented feat
0490: 75 72 65 20 61 6e 64 20 6d 61 79 20 6e 6f 74 20  ure and may not 
04a0: 62 65 20 73 75 70 70 6f 72 74 65 64 20 69 6e 20  be supported in 
04b0: 66 75 74 75 72 65 20 0a 2a 2a 20 72 65 6c 65 61  future .** relea
04c0: 73 65 73 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66  ses..*/.#if !def
04d0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d 55 54 45  ined(SQLITE_MUTE
04e0: 58 5f 44 45 46 41 55 4c 54 29 0a 23 20 64 65 66  X_DEFAULT).# def
04f0: 69 6e 65 20 53 51 4c 49 54 45 5f 4d 55 54 45 58  ine SQLITE_MUTEX
0500: 5f 44 45 46 41 55 4c 54 20 73 71 6c 69 74 65 33  _DEFAULT sqlite3
0510: 44 65 66 61 75 6c 74 4d 75 74 65 78 28 29 0a 23  DefaultMutex().#
0520: 65 6e 64 69 66 0a 0a 0a 23 69 66 6e 64 65 66 20  endif...#ifndef 
0530: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 4f 4d 49  SQLITE_MUTEX_OMI
0540: 54 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69  T./*.** Initiali
0550: 7a 65 20 74 68 65 20 6d 75 74 65 78 20 73 79 73  ze the mutex sys
0560: 74 65 6d 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  tem..*/.int sqli
0570: 74 65 33 4d 75 74 65 78 49 6e 69 74 28 76 6f 69  te3MutexInit(voi
0580: 64 29 7b 20 0a 20 20 69 6e 74 20 72 63 20 3d 20  d){ .  int rc = 
0590: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28  SQLITE_OK;.  if(
05a0: 20 21 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43   !sqlite3GlobalC
05b0: 6f 6e 66 69 67 2e 6d 75 74 65 78 2e 78 4d 75 74  onfig.mutex.xMut
05c0: 65 78 41 6c 6c 6f 63 20 29 7b 0a 20 20 20 20 2f  exAlloc ){.    /
05d0: 2a 20 49 66 20 74 68 65 20 78 4d 75 74 65 78 41  * If the xMutexA
05e0: 6c 6c 6f 63 20 6d 65 74 68 6f 64 20 68 61 73 20  lloc method has 
05f0: 6e 6f 74 20 62 65 65 6e 20 73 65 74 2c 20 74 68  not been set, th
0600: 65 6e 20 74 68 65 20 75 73 65 72 20 64 69 64 20  en the user did 
0610: 6e 6f 74 0a 20 20 20 20 2a 2a 20 69 6e 73 74 61  not.    ** insta
0620: 6c 6c 20 61 20 6d 75 74 65 78 20 69 6d 70 6c 65  ll a mutex imple
0630: 6d 65 6e 74 61 74 69 6f 6e 20 76 69 61 20 73 71  mentation via sq
0640: 6c 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 20 70  lite3_config() p
0650: 72 69 6f 72 20 74 6f 20 0a 20 20 20 20 2a 2a 20  rior to .    ** 
0660: 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69  sqlite3_initiali
0670: 7a 65 28 29 20 62 65 69 6e 67 20 63 61 6c 6c 65  ze() being calle
0680: 64 2e 20 54 68 69 73 20 62 6c 6f 63 6b 20 63 6f  d. This block co
0690: 70 69 65 73 20 70 6f 69 6e 74 65 72 73 20 74 6f  pies pointers to
06a0: 0a 20 20 20 20 2a 2a 20 74 68 65 20 64 65 66 61  .    ** the defa
06b0: 75 6c 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  ult implementati
06c0: 6f 6e 20 69 6e 74 6f 20 74 68 65 20 73 71 6c 69  on into the sqli
06d0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 20  te3GlobalConfig 
06e0: 73 74 72 75 63 74 75 72 65 2e 0a 20 20 20 20 2a  structure..    *
06f0: 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  /.    sqlite3_mu
0700: 74 65 78 5f 6d 65 74 68 6f 64 73 20 63 6f 6e 73  tex_methods cons
0710: 74 20 2a 70 46 72 6f 6d 3b 0a 20 20 20 20 73 71  t *pFrom;.    sq
0720: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68  lite3_mutex_meth
0730: 6f 64 73 20 2a 70 54 6f 20 3d 20 26 73 71 6c 69  ods *pTo = &sqli
0740: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
0750: 6d 75 74 65 78 3b 0a 0a 20 20 20 20 69 66 28 20  mutex;..    if( 
0760: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
0770: 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 29  fig.bCoreMutex )
0780: 7b 0a 20 20 20 20 20 20 70 46 72 6f 6d 20 3d 20  {.      pFrom = 
0790: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 44 45 46  SQLITE_MUTEX_DEF
07a0: 41 55 4c 54 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  AULT;.    }else{
07b0: 0a 20 20 20 20 20 20 70 46 72 6f 6d 20 3d 20 73  .      pFrom = s
07c0: 71 6c 69 74 65 33 4e 6f 6f 70 4d 75 74 65 78 28  qlite3NoopMutex(
07d0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d  );.    }.    mem
07e0: 63 70 79 28 70 54 6f 2c 20 70 46 72 6f 6d 2c 20  cpy(pTo, pFrom, 
07f0: 6f 66 66 73 65 74 6f 66 28 73 71 6c 69 74 65 33  offsetof(sqlite3
0800: 5f 6d 75 74 65 78 5f 6d 65 74 68 6f 64 73 2c 20  _mutex_methods, 
0810: 78 4d 75 74 65 78 41 6c 6c 6f 63 29 29 3b 0a 20  xMutexAlloc));. 
0820: 20 20 20 6d 65 6d 63 70 79 28 26 70 54 6f 2d 3e     memcpy(&pTo->
0830: 78 4d 75 74 65 78 46 72 65 65 2c 20 26 70 46 72  xMutexFree, &pFr
0840: 6f 6d 2d 3e 78 4d 75 74 65 78 46 72 65 65 2c 0a  om->xMutexFree,.
0850: 20 20 20 20 20 20 20 20 20 20 20 73 69 7a 65 6f             sizeo
0860: 66 28 2a 70 54 6f 29 20 2d 20 6f 66 66 73 65 74  f(*pTo) - offset
0870: 6f 66 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  of(sqlite3_mutex
0880: 5f 6d 65 74 68 6f 64 73 2c 20 78 4d 75 74 65 78  _methods, xMutex
0890: 46 72 65 65 29 29 3b 0a 20 20 20 20 70 54 6f 2d  Free));.    pTo-
08a0: 3e 78 4d 75 74 65 78 41 6c 6c 6f 63 20 3d 20 70  >xMutexAlloc = p
08b0: 46 72 6f 6d 2d 3e 78 4d 75 74 65 78 41 6c 6c 6f  From->xMutexAllo
08c0: 63 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71  c;.  }.  rc = sq
08d0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69  lite3GlobalConfi
08e0: 67 2e 6d 75 74 65 78 2e 78 4d 75 74 65 78 49 6e  g.mutex.xMutexIn
08f0: 69 74 28 29 3b 0a 0a 23 69 66 64 65 66 20 53 51  it();..#ifdef SQ
0900: 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 47 4c 4f  LITE_DEBUG.  GLO
0910: 42 41 4c 28 69 6e 74 2c 20 6d 75 74 65 78 49 73  BAL(int, mutexIs
0920: 49 6e 69 74 29 20 3d 20 31 3b 0a 23 65 6e 64 69  Init) = 1;.#endi
0930: 66 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  f..  return rc;.
0940: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 68 75 74 64 6f 77  }../*.** Shutdow
0950: 6e 20 74 68 65 20 6d 75 74 65 78 20 73 79 73 74  n the mutex syst
0960: 65 6d 2e 20 54 68 69 73 20 63 61 6c 6c 20 66 72  em. This call fr
0970: 65 65 73 20 72 65 73 6f 75 72 63 65 73 20 61 6c  ees resources al
0980: 6c 6f 63 61 74 65 64 20 62 79 0a 2a 2a 20 73 71  located by.** sq
0990: 6c 69 74 65 33 4d 75 74 65 78 49 6e 69 74 28 29  lite3MutexInit()
09a0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
09b0: 4d 75 74 65 78 45 6e 64 28 76 6f 69 64 29 7b 0a  MutexEnd(void){.
09c0: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
09d0: 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 73 71 6c 69  E_OK;.  if( sqli
09e0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
09f0: 6d 75 74 65 78 2e 78 4d 75 74 65 78 45 6e 64 20  mutex.xMutexEnd 
0a00: 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  ){.    rc = sqli
0a10: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e  te3GlobalConfig.
0a20: 6d 75 74 65 78 2e 78 4d 75 74 65 78 45 6e 64 28  mutex.xMutexEnd(
0a30: 29 3b 0a 20 20 7d 0a 0a 23 69 66 64 65 66 20 53  );.  }..#ifdef S
0a40: 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 47 4c  QLITE_DEBUG.  GL
0a50: 4f 42 41 4c 28 69 6e 74 2c 20 6d 75 74 65 78 49  OBAL(int, mutexI
0a60: 73 49 6e 69 74 29 20 3d 20 30 3b 0a 23 65 6e 64  sInit) = 0;.#end
0a70: 69 66 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b  if..  return rc;
0a80: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 72 69 65  .}../*.** Retrie
0a90: 76 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  ve a pointer to 
0aa0: 61 20 73 74 61 74 69 63 20 6d 75 74 65 78 20 6f  a static mutex o
0ab0: 72 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77  r allocate a new
0ac0: 20 64 79 6e 61 6d 69 63 20 6f 6e 65 2e 0a 2a 2f   dynamic one..*/
0ad0: 0a 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a  .sqlite3_mutex *
0ae0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c  sqlite3_mutex_al
0af0: 6c 6f 63 28 69 6e 74 20 69 64 29 7b 0a 23 69 66  loc(int id){.#if
0b00: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
0b10: 5f 41 55 54 4f 49 4e 49 54 0a 20 20 69 66 28 20  _AUTOINIT.  if( 
0b20: 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69  sqlite3_initiali
0b30: 7a 65 28 29 20 29 20 72 65 74 75 72 6e 20 30 3b  ze() ) return 0;
0b40: 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e  .#endif.  return
0b50: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
0b60: 6e 66 69 67 2e 6d 75 74 65 78 2e 78 4d 75 74 65  nfig.mutex.xMute
0b70: 78 41 6c 6c 6f 63 28 69 64 29 3b 0a 7d 0a 0a 73  xAlloc(id);.}..s
0b80: 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71  qlite3_mutex *sq
0b90: 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28  lite3MutexAlloc(
0ba0: 69 6e 74 20 69 64 29 7b 0a 20 20 69 66 28 20 21  int id){.  if( !
0bb0: 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e  sqlite3GlobalCon
0bc0: 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 29  fig.bCoreMutex )
0bd0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a  {.    return 0;.
0be0: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 47 4c    }.  assert( GL
0bf0: 4f 42 41 4c 28 69 6e 74 2c 20 6d 75 74 65 78 49  OBAL(int, mutexI
0c00: 73 49 6e 69 74 29 20 29 3b 0a 20 20 72 65 74 75  sInit) );.  retu
0c10: 72 6e 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c  rn sqlite3Global
0c20: 43 6f 6e 66 69 67 2e 6d 75 74 65 78 2e 78 4d 75  Config.mutex.xMu
0c30: 74 65 78 41 6c 6c 6f 63 28 69 64 29 3b 0a 7d 0a  texAlloc(id);.}.
0c40: 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 20 64 79  ./*.** Free a dy
0c50: 6e 61 6d 69 63 20 6d 75 74 65 78 2e 0a 2a 2f 0a  namic mutex..*/.
0c60: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 6d 75 74  void sqlite3_mut
0c70: 65 78 5f 66 72 65 65 28 73 71 6c 69 74 65 33 5f  ex_free(sqlite3_
0c80: 6d 75 74 65 78 20 2a 70 29 7b 0a 20 20 69 66 28  mutex *p){.  if(
0c90: 20 70 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65   p ){.    sqlite
0ca0: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 75  3GlobalConfig.mu
0cb0: 74 65 78 2e 78 4d 75 74 65 78 46 72 65 65 28 70  tex.xMutexFree(p
0cc0: 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  );.  }.}../*.** 
0cd0: 4f 62 74 61 69 6e 20 74 68 65 20 6d 75 74 65 78  Obtain the mutex
0ce0: 20 70 2e 20 49 66 20 73 6f 6d 65 20 6f 74 68 65   p. If some othe
0cf0: 72 20 74 68 72 65 61 64 20 61 6c 72 65 61 64 79  r thread already
0d00: 20 68 61 73 20 74 68 65 20 6d 75 74 65 78 2c 20   has the mutex, 
0d10: 62 6c 6f 63 6b 0a 2a 2a 20 75 6e 74 69 6c 20 69  block.** until i
0d20: 74 20 63 61 6e 20 62 65 20 6f 62 74 61 69 6e 65  t can be obtaine
0d30: 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  d..*/.void sqlit
0d40: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 73  e3_mutex_enter(s
0d50: 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 70 29  qlite3_mutex *p)
0d60: 7b 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20  {.  if( p ){.   
0d70: 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f   sqlite3GlobalCo
0d80: 6e 66 69 67 2e 6d 75 74 65 78 2e 78 4d 75 74 65  nfig.mutex.xMute
0d90: 78 45 6e 74 65 72 28 70 29 3b 0a 20 20 7d 0a 7d  xEnter(p);.  }.}
0da0: 0a 0a 2f 2a 0a 2a 2a 20 4f 62 74 61 69 6e 20 74  ../*.** Obtain t
0db0: 68 65 20 6d 75 74 65 78 20 70 2e 20 49 66 20 73  he mutex p. If s
0dc0: 75 63 63 65 73 73 66 75 6c 2c 20 72 65 74 75 72  uccessful, retur
0dd0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 4f 74 68  n SQLITE_OK. Oth
0de0: 65 72 77 69 73 65 2c 20 69 66 20 61 6e 6f 74 68  erwise, if anoth
0df0: 65 72 0a 2a 2a 20 74 68 72 65 61 64 20 68 6f 6c  er.** thread hol
0e00: 64 73 20 74 68 65 20 6d 75 74 65 78 20 61 6e 64  ds the mutex and
0e10: 20 69 74 20 63 61 6e 6e 6f 74 20 62 65 20 6f 62   it cannot be ob
0e20: 74 61 69 6e 65 64 2c 20 72 65 74 75 72 6e 20 53  tained, return S
0e30: 51 4c 49 54 45 5f 42 55 53 59 2e 0a 2a 2f 0a 69  QLITE_BUSY..*/.i
0e40: 6e 74 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  nt sqlite3_mutex
0e50: 5f 74 72 79 28 73 71 6c 69 74 65 33 5f 6d 75 74  _try(sqlite3_mut
0e60: 65 78 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63  ex *p){.  int rc
0e70: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
0e80: 69 66 28 20 70 20 29 7b 0a 20 20 20 20 72 65 74  if( p ){.    ret
0e90: 75 72 6e 20 73 71 6c 69 74 65 33 47 6c 6f 62 61  urn sqlite3Globa
0ea0: 6c 43 6f 6e 66 69 67 2e 6d 75 74 65 78 2e 78 4d  lConfig.mutex.xM
0eb0: 75 74 65 78 54 72 79 28 70 29 3b 0a 20 20 7d 0a  utexTry(p);.  }.
0ec0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
0ed0: 2f 2a 0a 2a 2a 20 54 68 65 20 73 71 6c 69 74 65  /*.** The sqlite
0ee0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 29 20  3_mutex_leave() 
0ef0: 72 6f 75 74 69 6e 65 20 65 78 69 74 73 20 61 20  routine exits a 
0f00: 6d 75 74 65 78 20 74 68 61 74 20 77 61 73 20 70  mutex that was p
0f10: 72 65 76 69 6f 75 73 6c 79 0a 2a 2a 20 65 6e 74  reviously.** ent
0f20: 65 72 65 64 20 62 79 20 74 68 65 20 73 61 6d 65  ered by the same
0f30: 20 74 68 72 65 61 64 2e 20 20 54 68 65 20 62 65   thread.  The be
0f40: 68 61 76 69 6f 72 20 69 73 20 75 6e 64 65 66 69  havior is undefi
0f50: 6e 65 64 20 69 66 20 74 68 65 20 6d 75 74 65 78  ned if the mutex
0f60: 20 0a 2a 2a 20 69 73 20 6e 6f 74 20 63 75 72 72   .** is not curr
0f70: 65 6e 74 6c 79 20 65 6e 74 65 72 65 64 2e 20 49  ently entered. I
0f80: 66 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72  f a NULL pointer
0f90: 20 69 73 20 70 61 73 73 65 64 20 61 73 20 61 6e   is passed as an
0fa0: 20 61 72 67 75 6d 65 6e 74 0a 2a 2a 20 74 68 69   argument.** thi
0fb0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20  s function is a 
0fc0: 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 76 6f 69 64 20 73  no-op..*/.void s
0fd0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
0fe0: 76 65 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  ve(sqlite3_mutex
0ff0: 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 20 29 7b   *p){.  if( p ){
1000: 0a 20 20 20 20 73 71 6c 69 74 65 33 47 6c 6f 62  .    sqlite3Glob
1010: 61 6c 43 6f 6e 66 69 67 2e 6d 75 74 65 78 2e 78  alConfig.mutex.x
1020: 4d 75 74 65 78 4c 65 61 76 65 28 70 29 3b 0a 20  MutexLeave(p);. 
1030: 20 7d 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 4e 44   }.}..#ifndef ND
1040: 45 42 55 47 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73  EBUG./*.** The s
1050: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
1060: 64 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33 5f  d() and sqlite3_
1070: 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28 29 20  mutex_notheld() 
1080: 72 6f 75 74 69 6e 65 20 61 72 65 0a 2a 2a 20 69  routine are.** i
1090: 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 65 20  ntended for use 
10a0: 69 6e 73 69 64 65 20 61 73 73 65 72 74 28 29 20  inside assert() 
10b0: 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2f 0a 69  statements..*/.i
10c0: 6e 74 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  nt sqlite3_mutex
10d0: 5f 68 65 6c 64 28 73 71 6c 69 74 65 33 5f 6d 75  _held(sqlite3_mu
10e0: 74 65 78 20 2a 70 29 7b 0a 20 20 72 65 74 75 72  tex *p){.  retur
10f0: 6e 20 70 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65  n p==0 || sqlite
1100: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e 6d 75  3GlobalConfig.mu
1110: 74 65 78 2e 78 4d 75 74 65 78 48 65 6c 64 28 70  tex.xMutexHeld(p
1120: 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  );.}.int sqlite3
1130: 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28 73  _mutex_notheld(s
1140: 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 70 29  qlite3_mutex *p)
1150: 7b 0a 20 20 72 65 74 75 72 6e 20 70 3d 3d 30 20  {.  return p==0 
1160: 7c 7c 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c  || sqlite3Global
1170: 43 6f 6e 66 69 67 2e 6d 75 74 65 78 2e 78 4d 75  Config.mutex.xMu
1180: 74 65 78 4e 6f 74 68 65 6c 64 28 70 29 3b 0a 7d  texNotheld(p);.}
1190: 0a 23 65 6e 64 69 66 0a 0a 23 65 6e 64 69 66 20  .#endif..#endif 
11a0: 2f 2a 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f  /* SQLITE_MUTEX_
11b0: 4f 4d 49 54 20 2a 2f 0a                          OMIT */.