/ Hex Artifact Content
Login

Artifact aa3ef56941dcaf480b6f055a615674fe4909edbc:


0000: 2f 2a 0a 2a 2a 20 32 30 30 34 20 4d 61 79 20 32  /*.** 2004 May 2
0010: 32 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68  2.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65  place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65  gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a   is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75  **.**    May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74   do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79   evil..**    May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76   you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65  eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f  lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79  thers..**    May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c   you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20  y, never taking 
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69  more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ve..**.*********
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 6d   file contains m
0190: 61 63 72 6f 73 20 61 6e 64 20 61 20 6c 69 74 74  acros and a litt
01a0: 6c 65 20 62 69 74 20 6f 66 20 63 6f 64 65 20 74  le bit of code t
01b0: 68 61 74 20 69 73 20 63 6f 6d 6d 6f 6e 20 74 6f  hat is common to
01c0: 0a 2a 2a 20 61 6c 6c 20 6f 66 20 74 68 65 20 70  .** all of the p
01d0: 6c 61 74 66 6f 72 6d 2d 73 70 65 63 69 66 69 63  latform-specific
01e0: 20 66 69 6c 65 73 20 28 6f 73 5f 2a 2e 63 29 20   files (os_*.c) 
01f0: 61 6e 64 20 69 73 20 23 69 6e 63 6c 75 64 65 64  and is #included
0200: 20 69 6e 74 6f 20 74 68 6f 73 65 0a 2a 2a 20 66   into those.** f
0210: 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73  iles..**.** This
0220: 20 66 69 6c 65 20 73 68 6f 75 6c 64 20 62 65 20   file should be 
0230: 23 69 6e 63 6c 75 64 65 64 20 62 79 20 74 68 65  #included by the
0240: 20 6f 73 5f 2a 2e 63 20 66 69 6c 65 73 20 6f 6e   os_*.c files on
0250: 6c 79 2e 20 20 49 74 20 69 73 20 6e 6f 74 20 61  ly.  It is not a
0260: 0a 2a 2a 20 67 65 6e 65 72 61 6c 20 70 75 72 70  .** general purp
0270: 6f 73 65 20 68 65 61 64 65 72 20 66 69 6c 65 2e  ose header file.
0280: 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 74 20 6c 65  .*/../*.** At le
0290: 61 73 74 20 74 77 6f 20 62 75 67 73 20 68 61 76  ast two bugs hav
02a0: 65 20 73 6c 69 70 70 65 64 20 69 6e 20 62 65 63  e slipped in bec
02b0: 61 75 73 65 20 77 65 20 63 68 61 6e 67 65 64 20  ause we changed 
02c0: 74 68 65 20 4d 45 4d 4f 52 59 5f 44 45 42 55 47  the MEMORY_DEBUG
02d0: 0a 2a 2a 20 6d 61 63 72 6f 20 74 6f 20 53 51 4c  .** macro to SQL
02e0: 49 54 45 5f 44 45 42 55 47 20 61 6e 64 20 73 6f  ITE_DEBUG and so
02f0: 6d 65 20 6f 6c 64 65 72 20 6d 61 6b 65 66 69 6c  me older makefil
0300: 65 73 20 68 61 76 65 20 6e 6f 74 20 79 65 74 20  es have not yet 
0310: 6d 61 64 65 20 74 68 65 0a 2a 2a 20 73 77 69 74  made the.** swit
0320: 63 68 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69  ch.  The followi
0330: 6e 67 20 63 6f 64 65 20 73 68 6f 75 6c 64 20 63  ng code should c
0340: 61 74 63 68 20 74 68 69 73 20 70 72 6f 62 6c 65  atch this proble
0350: 6d 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d  m at compile-tim
0360: 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 4d 45 4d  e..*/.#ifdef MEM
0370: 4f 52 59 5f 44 45 42 55 47 0a 23 20 65 72 72 6f  ORY_DEBUG.# erro
0380: 72 20 22 54 68 65 20 4d 45 4d 4f 52 59 5f 44 45  r "The MEMORY_DE
0390: 42 55 47 20 6d 61 63 72 6f 20 69 73 20 6f 62 73  BUG macro is obs
03a0: 6f 6c 65 74 65 2e 20 20 55 73 65 20 53 51 4c 49  olete.  Use SQLI
03b0: 54 45 5f 44 45 42 55 47 20 69 6e 73 74 65 61 64  TE_DEBUG instead
03c0: 2e 22 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 20  .".#endif.../*. 
03d0: 2a 20 57 68 65 6e 20 74 65 73 74 69 6e 67 2c 20  * When testing, 
03e0: 74 68 69 73 20 67 6c 6f 62 61 6c 20 76 61 72 69  this global vari
03f0: 61 62 6c 65 20 73 74 6f 72 65 73 20 74 68 65 20  able stores the 
0400: 6c 6f 63 61 74 69 6f 6e 20 6f 66 20 74 68 65 0a  location of the.
0410: 20 2a 20 70 65 6e 64 69 6e 67 2d 62 79 74 65 20   * pending-byte 
0420: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20  in the database 
0430: 66 69 6c 65 2e 0a 20 2a 2f 0a 23 69 66 64 65 66  file.. */.#ifdef
0440: 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 75 6e 73   SQLITE_TEST.uns
0450: 69 67 6e 65 64 20 69 6e 74 20 73 71 6c 69 74 65  igned int sqlite
0460: 33 5f 70 65 6e 64 69 6e 67 5f 62 79 74 65 20 3d  3_pending_byte =
0470: 20 30 78 34 30 30 30 30 30 30 30 3b 0a 23 65 6e   0x40000000;.#en
0480: 64 69 66 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33  dif..int sqlite3
0490: 5f 6f 73 5f 74 72 61 63 65 20 3d 20 30 3b 0a 23  _os_trace = 0;.#
04a0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42  ifdef SQLITE_DEB
04b0: 55 47 0a 73 74 61 74 69 63 20 69 6e 74 20 6c 61  UG.static int la
04c0: 73 74 5f 70 61 67 65 20 3d 20 30 3b 0a 23 64 65  st_page = 0;.#de
04d0: 66 69 6e 65 20 53 45 45 4b 28 58 29 20 20 20 20  fine SEEK(X)    
04e0: 20 20 20 20 20 20 20 6c 61 73 74 5f 70 61 67 65         last_page
04f0: 3d 28 58 29 0a 23 64 65 66 69 6e 65 20 54 52 41  =(X).#define TRA
0500: 43 45 31 28 58 29 20 20 20 20 20 20 20 20 20 69  CE1(X)         i
0510: 66 28 20 73 71 6c 69 74 65 33 5f 6f 73 5f 74 72  f( sqlite3_os_tr
0520: 61 63 65 20 29 20 73 71 6c 69 74 65 33 44 65 62  ace ) sqlite3Deb
0530: 75 67 50 72 69 6e 74 66 28 58 29 0a 23 64 65 66  ugPrintf(X).#def
0540: 69 6e 65 20 54 52 41 43 45 32 28 58 2c 59 29 20  ine TRACE2(X,Y) 
0550: 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65        if( sqlite
0560: 33 5f 6f 73 5f 74 72 61 63 65 20 29 20 73 71 6c  3_os_trace ) sql
0570: 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28  ite3DebugPrintf(
0580: 58 2c 59 29 0a 23 64 65 66 69 6e 65 20 54 52 41  X,Y).#define TRA
0590: 43 45 33 28 58 2c 59 2c 5a 29 20 20 20 20 20 69  CE3(X,Y,Z)     i
05a0: 66 28 20 73 71 6c 69 74 65 33 5f 6f 73 5f 74 72  f( sqlite3_os_tr
05b0: 61 63 65 20 29 20 73 71 6c 69 74 65 33 44 65 62  ace ) sqlite3Deb
05c0: 75 67 50 72 69 6e 74 66 28 58 2c 59 2c 5a 29 0a  ugPrintf(X,Y,Z).
05d0: 23 64 65 66 69 6e 65 20 54 52 41 43 45 34 28 58  #define TRACE4(X
05e0: 2c 59 2c 5a 2c 41 29 20 20 20 69 66 28 20 73 71  ,Y,Z,A)   if( sq
05f0: 6c 69 74 65 33 5f 6f 73 5f 74 72 61 63 65 20 29  lite3_os_trace )
0600: 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69   sqlite3DebugPri
0610: 6e 74 66 28 58 2c 59 2c 5a 2c 41 29 0a 23 64 65  ntf(X,Y,Z,A).#de
0620: 66 69 6e 65 20 54 52 41 43 45 35 28 58 2c 59 2c  fine TRACE5(X,Y,
0630: 5a 2c 41 2c 42 29 20 69 66 28 20 73 71 6c 69 74  Z,A,B) if( sqlit
0640: 65 33 5f 6f 73 5f 74 72 61 63 65 20 29 20 73 71  e3_os_trace ) sq
0650: 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66  lite3DebugPrintf
0660: 28 58 2c 59 2c 5a 2c 41 2c 42 29 0a 23 64 65 66  (X,Y,Z,A,B).#def
0670: 69 6e 65 20 54 52 41 43 45 36 28 58 2c 59 2c 5a  ine TRACE6(X,Y,Z
0680: 2c 41 2c 42 2c 43 29 20 69 66 28 73 71 6c 69 74  ,A,B,C) if(sqlit
0690: 65 33 5f 6f 73 5f 74 72 61 63 65 29 20 73 71 6c  e3_os_trace) sql
06a0: 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28  ite3DebugPrintf(
06b0: 58 2c 59 2c 5a 2c 41 2c 42 2c 43 29 0a 23 64 65  X,Y,Z,A,B,C).#de
06c0: 66 69 6e 65 20 54 52 41 43 45 37 28 58 2c 59 2c  fine TRACE7(X,Y,
06d0: 5a 2c 41 2c 42 2c 43 2c 44 29 20 5c 0a 20 20 20  Z,A,B,C,D) \.   
06e0: 20 69 66 28 73 71 6c 69 74 65 33 5f 6f 73 5f 74   if(sqlite3_os_t
06f0: 72 61 63 65 29 20 73 71 6c 69 74 65 33 44 65 62  race) sqlite3Deb
0700: 75 67 50 72 69 6e 74 66 28 58 2c 59 2c 5a 2c 41  ugPrintf(X,Y,Z,A
0710: 2c 42 2c 43 2c 44 29 0a 23 65 6c 73 65 0a 23 64  ,B,C,D).#else.#d
0720: 65 66 69 6e 65 20 53 45 45 4b 28 58 29 0a 23 64  efine SEEK(X).#d
0730: 65 66 69 6e 65 20 54 52 41 43 45 31 28 58 29 0a  efine TRACE1(X).
0740: 23 64 65 66 69 6e 65 20 54 52 41 43 45 32 28 58  #define TRACE2(X
0750: 2c 59 29 0a 23 64 65 66 69 6e 65 20 54 52 41 43  ,Y).#define TRAC
0760: 45 33 28 58 2c 59 2c 5a 29 0a 23 64 65 66 69 6e  E3(X,Y,Z).#defin
0770: 65 20 54 52 41 43 45 34 28 58 2c 59 2c 5a 2c 41  e TRACE4(X,Y,Z,A
0780: 29 0a 23 64 65 66 69 6e 65 20 54 52 41 43 45 35  ).#define TRACE5
0790: 28 58 2c 59 2c 5a 2c 41 2c 42 29 0a 23 64 65 66  (X,Y,Z,A,B).#def
07a0: 69 6e 65 20 54 52 41 43 45 36 28 58 2c 59 2c 5a  ine TRACE6(X,Y,Z
07b0: 2c 41 2c 42 2c 43 29 0a 23 64 65 66 69 6e 65 20  ,A,B,C).#define 
07c0: 54 52 41 43 45 37 28 58 2c 59 2c 5a 2c 41 2c 42  TRACE7(X,Y,Z,A,B
07d0: 2c 43 2c 44 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a  ,C,D).#endif../*
07e0: 0a 2a 2a 20 4d 61 63 72 6f 73 20 66 6f 72 20 70  .** Macros for p
07f0: 65 72 66 6f 72 6d 61 6e 63 65 20 74 72 61 63 69  erformance traci
0800: 6e 67 2e 20 20 4e 6f 72 6d 61 6c 6c 79 20 74 75  ng.  Normally tu
0810: 72 6e 65 64 20 6f 66 66 2e 20 20 4f 6e 6c 79 20  rned off.  Only 
0820: 77 6f 72 6b 73 0a 2a 2a 20 6f 6e 20 69 34 38 36  works.** on i486
0830: 20 68 61 72 64 77 61 72 65 2e 0a 2a 2f 0a 23 69   hardware..*/.#i
0840: 66 64 65 66 20 53 51 4c 49 54 45 5f 50 45 52 46  fdef SQLITE_PERF
0850: 4f 52 4d 41 4e 43 45 5f 54 52 41 43 45 0a 5f 5f  ORMANCE_TRACE.__
0860: 69 6e 6c 69 6e 65 5f 5f 20 75 6e 73 69 67 6e 65  inline__ unsigne
0870: 64 20 6c 6f 6e 67 20 6c 6f 6e 67 20 69 6e 74 20  d long long int 
0880: 68 77 74 69 6d 65 28 76 6f 69 64 29 7b 0a 20 20  hwtime(void){.  
0890: 75 6e 73 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f  unsigned long lo
08a0: 6e 67 20 69 6e 74 20 78 3b 0a 20 20 5f 5f 61 73  ng int x;.  __as
08b0: 6d 5f 5f 28 22 72 64 74 73 63 5c 6e 5c 74 22 0a  m__("rdtsc\n\t".
08c0: 20 20 20 20 20 20 20 20 20 20 22 6d 6f 76 20 25            "mov %
08d0: 25 65 64 78 2c 20 25 25 65 63 78 5c 6e 5c 74 22  %edx, %%ecx\n\t"
08e0: 0a 20 20 20 20 20 20 20 20 20 20 3a 22 3d 41 22  .          :"=A"
08f0: 20 28 78 29 29 3b 0a 20 20 72 65 74 75 72 6e 20   (x));.  return 
0900: 78 3b 0a 7d 0a 73 74 61 74 69 63 20 75 6e 73 69  x;.}.static unsi
0910: 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e 67 20 69  gned long long i
0920: 6e 74 20 67 5f 73 74 61 72 74 3b 0a 73 74 61 74  nt g_start;.stat
0930: 69 63 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  ic unsigned int 
0940: 65 6c 61 70 73 65 3b 0a 23 64 65 66 69 6e 65 20  elapse;.#define 
0950: 54 49 4d 45 52 5f 53 54 41 52 54 20 20 20 20 20  TIMER_START     
0960: 20 20 67 5f 73 74 61 72 74 3d 68 77 74 69 6d 65    g_start=hwtime
0970: 28 29 0a 23 64 65 66 69 6e 65 20 54 49 4d 45 52  ().#define TIMER
0980: 5f 45 4e 44 20 20 20 20 20 20 20 20 20 65 6c 61  _END         ela
0990: 70 73 65 3d 68 77 74 69 6d 65 28 29 2d 67 5f 73  pse=hwtime()-g_s
09a0: 74 61 72 74 0a 23 64 65 66 69 6e 65 20 54 49 4d  tart.#define TIM
09b0: 45 52 5f 45 4c 41 50 53 45 44 20 20 20 20 20 65  ER_ELAPSED     e
09c0: 6c 61 70 73 65 0a 23 65 6c 73 65 0a 23 64 65 66  lapse.#else.#def
09d0: 69 6e 65 20 54 49 4d 45 52 5f 53 54 41 52 54 0a  ine TIMER_START.
09e0: 23 64 65 66 69 6e 65 20 54 49 4d 45 52 5f 45 4e  #define TIMER_EN
09f0: 44 0a 23 64 65 66 69 6e 65 20 54 49 4d 45 52 5f  D.#define TIMER_
0a00: 45 4c 41 50 53 45 44 20 20 20 20 20 30 0a 23 65  ELAPSED     0.#e
0a10: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 77  ndif../*.** If w
0a20: 65 20 63 6f 6d 70 69 6c 65 20 77 69 74 68 20 74  e compile with t
0a30: 68 65 20 53 51 4c 49 54 45 5f 54 45 53 54 20 6d  he SQLITE_TEST m
0a40: 61 63 72 6f 20 73 65 74 2c 20 74 68 65 6e 20 74  acro set, then t
0a50: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f  he following blo
0a60: 63 6b 0a 2a 2a 20 6f 66 20 63 6f 64 65 20 77 69  ck.** of code wi
0a70: 6c 6c 20 67 69 76 65 20 75 73 20 74 68 65 20 61  ll give us the a
0a80: 62 69 6c 69 74 79 20 74 6f 20 73 69 6d 75 6c 61  bility to simula
0a90: 74 65 20 61 20 64 69 73 6b 20 49 2f 4f 20 65 72  te a disk I/O er
0aa0: 72 6f 72 2e 20 20 54 68 69 73 0a 2a 2a 20 69 73  ror.  This.** is
0ab0: 20 75 73 65 64 20 66 6f 72 20 74 65 73 74 69 6e   used for testin
0ac0: 67 20 74 68 65 20 49 2f 4f 20 72 65 63 6f 76 65  g the I/O recove
0ad0: 72 79 20 6c 6f 67 69 63 2e 0a 2a 2f 0a 23 69 66  ry logic..*/.#if
0ae0: 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a  def SQLITE_TEST.
0af0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65  int sqlite3_io_e
0b00: 72 72 6f 72 5f 68 69 74 20 3d 20 30 3b 0a 69 6e  rror_hit = 0;.in
0b10: 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72  t sqlite3_io_err
0b20: 6f 72 5f 70 65 6e 64 69 6e 67 20 3d 20 30 3b 0a  or_pending = 0;.
0b30: 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65  int sqlite3_io_e
0b40: 72 72 6f 72 5f 70 65 72 73 69 73 74 20 3d 20 30  rror_persist = 0
0b50: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64 69  ;.int sqlite3_di
0b60: 73 6b 66 75 6c 6c 5f 70 65 6e 64 69 6e 67 20 3d  skfull_pending =
0b70: 20 30 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f   0;.int sqlite3_
0b80: 64 69 73 6b 66 75 6c 6c 20 3d 20 30 3b 0a 23 64  diskfull = 0;.#d
0b90: 65 66 69 6e 65 20 53 69 6d 75 6c 61 74 65 49 4f  efine SimulateIO
0ba0: 45 72 72 6f 72 28 43 4f 44 45 29 20 20 5c 0a 20  Error(CODE)  \. 
0bb0: 20 69 66 28 20 73 71 6c 69 74 65 33 5f 69 6f 5f   if( sqlite3_io_
0bc0: 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67 20 7c 7c  error_pending ||
0bd0: 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f   sqlite3_io_erro
0be0: 72 5f 68 69 74 20 29 20 5c 0a 20 20 20 20 20 69  r_hit ) \.     i
0bf0: 66 28 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72  f( sqlite3_io_er
0c00: 72 6f 72 5f 70 65 6e 64 69 6e 67 2d 2d 20 3d 3d  ror_pending-- ==
0c10: 20 31 20 5c 0a 20 20 20 20 20 20 20 20 20 7c 7c   1 \.         ||
0c20: 20 28 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72   (sqlite3_io_err
0c30: 6f 72 5f 70 65 72 73 69 73 74 20 26 26 20 73 71  or_persist && sq
0c40: 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 68  lite3_io_error_h
0c50: 69 74 29 20 29 20 5c 0a 20 20 20 20 20 20 20 20  it) ) \.        
0c60: 20 20 20 20 20 20 20 20 7b 20 6c 6f 63 61 6c 5f          { local_
0c70: 69 6f 65 72 72 28 29 3b 20 43 4f 44 45 3b 20 7d  ioerr(); CODE; }
0c80: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6c 6f 63  .static void loc
0c90: 61 6c 5f 69 6f 65 72 72 28 29 7b 0a 20 20 73 71  al_ioerr(){.  sq
0ca0: 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 68  lite3_io_error_h
0cb0: 69 74 20 3d 20 31 3b 0a 7d 0a 23 64 65 66 69 6e  it = 1;.}.#defin
0cc0: 65 20 53 69 6d 75 6c 61 74 65 44 69 73 6b 66 75  e SimulateDiskfu
0cd0: 6c 6c 45 72 72 6f 72 28 43 4f 44 45 29 20 5c 0a  llError(CODE) \.
0ce0: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 64     if( sqlite3_d
0cf0: 69 73 6b 66 75 6c 6c 5f 70 65 6e 64 69 6e 67 20  iskfull_pending 
0d00: 29 7b 20 5c 0a 20 20 20 20 20 69 66 28 20 73 71  ){ \.     if( sq
0d10: 6c 69 74 65 33 5f 64 69 73 6b 66 75 6c 6c 5f 70  lite3_diskfull_p
0d20: 65 6e 64 69 6e 67 20 3d 3d 20 31 20 29 7b 20 5c  ending == 1 ){ \
0d30: 0a 20 20 20 20 20 20 20 6c 6f 63 61 6c 5f 69 6f  .       local_io
0d40: 65 72 72 28 29 3b 20 5c 0a 20 20 20 20 20 20 20  err(); \.       
0d50: 73 71 6c 69 74 65 33 5f 64 69 73 6b 66 75 6c 6c  sqlite3_diskfull
0d60: 20 3d 20 31 3b 20 5c 0a 20 20 20 20 20 20 20 73   = 1; \.       s
0d70: 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f  qlite3_io_error_
0d80: 68 69 74 20 3d 20 31 3b 20 5c 0a 20 20 20 20 20  hit = 1; \.     
0d90: 20 20 43 4f 44 45 3b 20 5c 0a 20 20 20 20 20 7d    CODE; \.     }
0da0: 65 6c 73 65 7b 20 5c 0a 20 20 20 20 20 20 20 73  else{ \.       s
0db0: 71 6c 69 74 65 33 5f 64 69 73 6b 66 75 6c 6c 5f  qlite3_diskfull_
0dc0: 70 65 6e 64 69 6e 67 2d 2d 3b 20 5c 0a 20 20 20  pending--; \.   
0dd0: 20 20 7d 20 5c 0a 20 20 20 7d 0a 23 65 6c 73 65    } \.   }.#else
0de0: 0a 23 64 65 66 69 6e 65 20 53 69 6d 75 6c 61 74  .#define Simulat
0df0: 65 49 4f 45 72 72 6f 72 28 41 29 0a 23 64 65 66  eIOError(A).#def
0e00: 69 6e 65 20 53 69 6d 75 6c 61 74 65 44 69 73 6b  ine SimulateDisk
0e10: 66 75 6c 6c 45 72 72 6f 72 28 41 29 0a 23 65 6e  fullError(A).#en
0e20: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 57 68 65 6e 20  dif../*.** When 
0e30: 74 65 73 74 69 6e 67 2c 20 6b 65 65 70 20 61 20  testing, keep a 
0e40: 63 6f 75 6e 74 20 6f 66 20 74 68 65 20 6e 75 6d  count of the num
0e50: 62 65 72 20 6f 66 20 6f 70 65 6e 20 66 69 6c 65  ber of open file
0e60: 73 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c  s..*/.#ifdef SQL
0e70: 49 54 45 5f 54 45 53 54 0a 69 6e 74 20 73 71 6c  ITE_TEST.int sql
0e80: 69 74 65 33 5f 6f 70 65 6e 5f 66 69 6c 65 5f 63  ite3_open_file_c
0e90: 6f 75 6e 74 20 3d 20 30 3b 0a 23 64 65 66 69 6e  ount = 0;.#defin
0ea0: 65 20 4f 70 65 6e 43 6f 75 6e 74 65 72 28 58 29  e OpenCounter(X)
0eb0: 20 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 66    sqlite3_open_f
0ec0: 69 6c 65 5f 63 6f 75 6e 74 2b 3d 28 58 29 0a 23  ile_count+=(X).#
0ed0: 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 4f 70 65  else.#define Ope
0ee0: 6e 43 6f 75 6e 74 65 72 28 58 29 0a 23 65 6e 64  nCounter(X).#end
0ef0: 69 66 0a 0a 2f 2a 0a 2a 2a 20 73 71 6c 69 74 65  if../*.** sqlite
0f00: 33 47 65 6e 65 72 69 63 4d 61 6c 6c 6f 63 0a 2a  3GenericMalloc.*
0f10: 2a 20 73 71 6c 69 74 65 33 47 65 6e 65 72 69 63  * sqlite3Generic
0f20: 52 65 61 6c 6c 6f 63 0a 2a 2a 20 73 71 6c 69 74  Realloc.** sqlit
0f30: 65 33 47 65 6e 65 72 69 63 4f 73 46 72 65 65 0a  e3GenericOsFree.
0f40: 2a 2a 20 73 71 6c 69 74 65 33 47 65 6e 65 72 69  ** sqlite3Generi
0f50: 63 41 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a 65 0a  cAllocationSize.
0f60: 2a 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e 74 61  **.** Implementa
0f70: 74 69 6f 6e 20 6f 66 20 74 68 65 20 6f 73 20 6c  tion of the os l
0f80: 65 76 65 6c 20 64 79 6e 61 6d 69 63 20 6d 65 6d  evel dynamic mem
0f90: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69  ory allocation i
0fa0: 6e 74 65 72 66 61 63 65 20 69 6e 20 74 65 72 6d  nterface in term
0fb0: 73 0a 2a 2a 20 6f 66 20 74 68 65 20 73 74 61 6e  s.** of the stan
0fc0: 64 61 72 64 20 6d 61 6c 6c 6f 63 28 29 2c 20 72  dard malloc(), r
0fd0: 65 61 6c 6c 6f 63 28 29 20 61 6e 64 20 66 72 65  ealloc() and fre
0fe0: 65 28 29 20 66 6f 75 6e 64 20 69 6e 20 6d 61 6e  e() found in man
0ff0: 79 20 6f 70 65 72 61 74 69 6e 67 0a 2a 2a 20 73  y operating.** s
1000: 79 73 74 65 6d 73 2e 20 4e 6f 20 72 6f 63 6b 65  ystems. No rocke
1010: 74 20 73 63 69 65 6e 63 65 20 68 65 72 65 2e 0a  t science here..
1020: 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 61 72 65 20  **.** There are 
1030: 74 77 6f 20 76 65 72 73 69 6f 6e 73 20 6f 66 20  two versions of 
1040: 74 68 65 73 65 20 66 6f 75 72 20 66 75 6e 63 74  these four funct
1050: 69 6f 6e 73 20 68 65 72 65 2e 20 54 68 65 20 76  ions here. The v
1060: 65 72 73 69 6f 6e 0a 2a 2a 20 69 6d 70 6c 65 6d  ersion.** implem
1070: 65 6e 74 65 64 20 68 65 72 65 20 69 73 20 6f 6e  ented here is on
1080: 6c 79 20 75 73 65 64 20 69 66 20 6d 65 6d 6f 72  ly used if memor
1090: 79 2d 6d 61 6e 61 67 65 6d 65 6e 74 20 6f 72 20  y-management or 
10a0: 6d 65 6d 6f 72 79 2d 64 65 62 75 67 67 69 6e 67  memory-debugging
10b0: 20 69 73 0a 2a 2a 20 65 6e 61 62 6c 65 64 2e 20   is.** enabled. 
10c0: 54 68 69 73 20 76 65 72 73 69 6f 6e 20 61 6c 6c  This version all
10d0: 6f 63 61 74 65 73 20 61 6e 20 65 78 74 72 61 20  ocates an extra 
10e0: 38 2d 62 79 74 65 73 20 61 74 20 74 68 65 20 62  8-bytes at the b
10f0: 65 67 69 6e 6e 69 6e 67 20 6f 66 20 65 61 63 68  eginning of each
1100: 0a 2a 2a 20 62 6c 6f 63 6b 20 61 6e 64 20 73 74  .** block and st
1110: 6f 72 65 73 20 74 68 65 20 73 69 7a 65 20 6f 66  ores the size of
1120: 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20   the allocation 
1130: 74 68 65 72 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  there..**.** If 
1140: 6e 65 69 74 68 65 72 20 6d 65 6d 6f 72 79 2d 6d  neither memory-m
1150: 61 6e 61 67 65 6d 65 6e 74 20 6f 72 20 64 65 62  anagement or deb
1160: 75 67 67 69 6e 67 20 69 73 20 65 6e 61 62 6c 65  ugging is enable
1170: 64 2c 20 74 68 65 20 73 65 63 6f 6e 64 0a 2a 2a  d, the second.**
1180: 20 73 65 74 20 6f 66 20 69 6d 70 6c 65 6d 65 6e   set of implemen
1190: 74 61 74 69 6f 6e 73 20 69 73 20 75 73 65 64 20  tations is used 
11a0: 69 6e 73 74 65 61 64 2e 0a 2a 2f 0a 23 69 66 20  instead..*/.#if 
11b0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45  defined(SQLITE_E
11c0: 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e  NABLE_MEMORY_MAN
11d0: 41 47 45 4d 45 4e 54 29 20 7c 7c 20 64 65 66 69  AGEMENT) || defi
11e0: 6e 65 64 20 28 53 51 4c 49 54 45 5f 4d 45 4d 44  ned (SQLITE_MEMD
11f0: 45 42 55 47 29 0a 76 6f 69 64 20 2a 73 71 6c 69  EBUG).void *sqli
1200: 74 65 33 47 65 6e 65 72 69 63 4d 61 6c 6c 6f 63  te3GenericMalloc
1210: 28 69 6e 74 20 6e 29 7b 0a 20 20 63 68 61 72 20  (int n){.  char 
1220: 2a 70 20 3d 20 28 63 68 61 72 20 2a 29 6d 61 6c  *p = (char *)mal
1230: 6c 6f 63 28 6e 2b 38 29 3b 0a 20 20 61 73 73 65  loc(n+8);.  asse
1240: 72 74 28 6e 3e 30 29 3b 0a 20 20 61 73 73 65 72  rt(n>0);.  asser
1250: 74 28 73 69 7a 65 6f 66 28 69 6e 74 29 3c 3d 38  t(sizeof(int)<=8
1260: 29 3b 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20  );.  if( p ){.  
1270: 20 20 2a 28 69 6e 74 20 2a 29 70 20 3d 20 6e 3b    *(int *)p = n;
1280: 0a 20 20 20 20 70 20 2b 3d 20 38 3b 0a 20 20 7d  .    p += 8;.  }
1290: 0a 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 20  .  return (void 
12a0: 2a 29 70 3b 0a 7d 0a 76 6f 69 64 20 2a 73 71 6c  *)p;.}.void *sql
12b0: 69 74 65 33 47 65 6e 65 72 69 63 52 65 61 6c 6c  ite3GenericReall
12c0: 6f 63 28 76 6f 69 64 20 2a 70 2c 20 69 6e 74 20  oc(void *p, int 
12d0: 6e 29 7b 0a 20 20 63 68 61 72 20 2a 70 32 20 3d  n){.  char *p2 =
12e0: 20 28 28 63 68 61 72 20 2a 29 70 20 2d 20 38 29   ((char *)p - 8)
12f0: 3b 0a 20 20 61 73 73 65 72 74 28 6e 3e 30 29 3b  ;.  assert(n>0);
1300: 0a 20 20 70 32 20 3d 20 28 63 68 61 72 2a 29 72  .  p2 = (char*)r
1310: 65 61 6c 6c 6f 63 28 70 32 2c 20 6e 2b 38 29 3b  ealloc(p2, n+8);
1320: 0a 20 20 69 66 28 20 70 32 20 29 7b 0a 20 20 20  .  if( p2 ){.   
1330: 20 2a 28 69 6e 74 20 2a 29 70 32 20 3d 20 6e 3b   *(int *)p2 = n;
1340: 0a 20 20 20 20 70 32 20 2b 3d 20 38 3b 0a 20 20  .    p2 += 8;.  
1350: 7d 0a 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64  }.  return (void
1360: 20 2a 29 70 32 3b 0a 7d 0a 76 6f 69 64 20 73 71   *)p2;.}.void sq
1370: 6c 69 74 65 33 47 65 6e 65 72 69 63 46 72 65 65  lite3GenericFree
1380: 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20 61 73 73  (void *p){.  ass
1390: 65 72 74 28 70 29 3b 0a 20 20 66 72 65 65 28 28  ert(p);.  free((
13a0: 76 6f 69 64 20 2a 29 28 28 63 68 61 72 20 2a 29  void *)((char *)
13b0: 70 20 2d 20 38 29 29 3b 0a 7d 0a 69 6e 74 20 73  p - 8));.}.int s
13c0: 71 6c 69 74 65 33 47 65 6e 65 72 69 63 41 6c 6c  qlite3GenericAll
13d0: 6f 63 61 74 69 6f 6e 53 69 7a 65 28 76 6f 69 64  ocationSize(void
13e0: 20 2a 70 29 7b 0a 20 20 72 65 74 75 72 6e 20 70   *p){.  return p
13f0: 20 3f 20 2a 28 69 6e 74 20 2a 29 28 28 63 68 61   ? *(int *)((cha
1400: 72 20 2a 29 70 20 2d 20 38 29 20 3a 20 30 3b 0a  r *)p - 8) : 0;.
1410: 7d 0a 23 65 6c 73 65 0a 76 6f 69 64 20 2a 73 71  }.#else.void *sq
1420: 6c 69 74 65 33 47 65 6e 65 72 69 63 4d 61 6c 6c  lite3GenericMall
1430: 6f 63 28 69 6e 74 20 6e 29 7b 0a 20 20 63 68 61  oc(int n){.  cha
1440: 72 20 2a 70 20 3d 20 28 63 68 61 72 20 2a 29 6d  r *p = (char *)m
1450: 61 6c 6c 6f 63 28 6e 29 3b 0a 20 20 72 65 74 75  alloc(n);.  retu
1460: 72 6e 20 28 76 6f 69 64 20 2a 29 70 3b 0a 7d 0a  rn (void *)p;.}.
1470: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 47 65 6e  void *sqlite3Gen
1480: 65 72 69 63 52 65 61 6c 6c 6f 63 28 76 6f 69 64  ericRealloc(void
1490: 20 2a 70 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 61   *p, int n){.  a
14a0: 73 73 65 72 74 28 6e 3e 30 29 3b 0a 20 20 70 20  ssert(n>0);.  p 
14b0: 3d 20 72 65 61 6c 6c 6f 63 28 70 2c 20 6e 29 3b  = realloc(p, n);
14c0: 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 76  .  return p;.}.v
14d0: 6f 69 64 20 73 71 6c 69 74 65 33 47 65 6e 65 72  oid sqlite3Gener
14e0: 69 63 46 72 65 65 28 76 6f 69 64 20 2a 70 29 7b  icFree(void *p){
14f0: 0a 20 20 61 73 73 65 72 74 28 70 29 3b 0a 20 20  .  assert(p);.  
1500: 66 72 65 65 28 70 29 3b 0a 7d 0a 2f 2a 20 4e 65  free(p);.}./* Ne
1510: 76 65 72 20 61 63 74 75 61 6c 6c 79 20 75 73 65  ver actually use
1520: 64 2c 20 62 75 74 20 6e 65 65 64 65 64 20 66 6f  d, but needed fo
1530: 72 20 74 68 65 20 6c 69 6e 6b 65 72 20 2a 2f 0a  r the linker */.
1540: 69 6e 74 20 73 71 6c 69 74 65 33 47 65 6e 65 72  int sqlite3Gener
1550: 69 63 41 6c 6c 6f 63 61 74 69 6f 6e 53 69 7a 65  icAllocationSize
1560: 28 76 6f 69 64 20 2a 70 29 7b 20 72 65 74 75 72  (void *p){ retur
1570: 6e 20 30 3b 20 7d 0a 23 65 6e 64 69 66 0a 0a 2f  n 0; }.#endif../
1580: 2a 0a 2a 2a 20 54 68 65 20 64 65 66 61 75 6c 74  *.** The default
1590: 20 73 69 7a 65 20 6f 66 20 61 20 64 69 73 6b 20   size of a disk 
15a0: 73 65 63 74 6f 72 0a 2a 2f 0a 23 69 66 6e 64 65  sector.*/.#ifnde
15b0: 66 20 50 41 47 45 52 5f 53 45 43 54 4f 52 5f 53  f PAGER_SECTOR_S
15c0: 49 5a 45 0a 23 20 64 65 66 69 6e 65 20 50 41 47  IZE.# define PAG
15d0: 45 52 5f 53 45 43 54 4f 52 5f 53 49 5a 45 20 35  ER_SECTOR_SIZE 5
15e0: 31 32 0a 23 65 6e 64 69 66 0a 73 74 61 74 69 63  12.#endif.static
15f0: 20 69 6e 74 20 6f 73 47 65 6e 65 72 69 63 53 65   int osGenericSe
1600: 63 74 6f 72 53 69 7a 65 28 4f 73 46 69 6c 65 20  ctorSize(OsFile 
1610: 2a 69 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 50  *id){.  return P
1620: 41 47 45 52 5f 53 45 43 54 4f 52 5f 53 49 5a 45  AGER_SECTOR_SIZE
1630: 3b 0a 7d 0a 0a                                   ;.}..