/ Hex Artifact Content
Login

Artifact a5c446d3b93f09f369d13bf217de4bed3437dd1c:


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 23 69 66 64 65 66 20 53 51 4c 49  dif..#ifdef SQLI
0490: 54 45 5f 44 45 42 55 47 0a 69 6e 74 20 73 71 6c  TE_DEBUG.int sql
04a0: 69 74 65 33 5f 6f 73 5f 74 72 61 63 65 20 3d 20  ite3_os_trace = 
04b0: 30 3b 0a 23 64 65 66 69 6e 65 20 4f 53 54 52 41  0;.#define OSTRA
04c0: 43 45 31 28 58 29 20 20 20 20 20 20 20 20 20 69  CE1(X)         i
04d0: 66 28 20 73 71 6c 69 74 65 33 5f 6f 73 5f 74 72  f( sqlite3_os_tr
04e0: 61 63 65 20 29 20 73 71 6c 69 74 65 33 44 65 62  ace ) sqlite3Deb
04f0: 75 67 50 72 69 6e 74 66 28 58 29 0a 23 64 65 66  ugPrintf(X).#def
0500: 69 6e 65 20 4f 53 54 52 41 43 45 32 28 58 2c 59  ine OSTRACE2(X,Y
0510: 29 20 20 20 20 20 20 20 69 66 28 20 73 71 6c 69  )       if( sqli
0520: 74 65 33 5f 6f 73 5f 74 72 61 63 65 20 29 20 73  te3_os_trace ) s
0530: 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e 74  qlite3DebugPrint
0540: 66 28 58 2c 59 29 0a 23 64 65 66 69 6e 65 20 4f  f(X,Y).#define O
0550: 53 54 52 41 43 45 33 28 58 2c 59 2c 5a 29 20 20  STRACE3(X,Y,Z)  
0560: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 6f     if( sqlite3_o
0570: 73 5f 74 72 61 63 65 20 29 20 73 71 6c 69 74 65  s_trace ) sqlite
0580: 33 44 65 62 75 67 50 72 69 6e 74 66 28 58 2c 59  3DebugPrintf(X,Y
0590: 2c 5a 29 0a 23 64 65 66 69 6e 65 20 4f 53 54 52  ,Z).#define OSTR
05a0: 41 43 45 34 28 58 2c 59 2c 5a 2c 41 29 20 20 20  ACE4(X,Y,Z,A)   
05b0: 69 66 28 20 73 71 6c 69 74 65 33 5f 6f 73 5f 74  if( sqlite3_os_t
05c0: 72 61 63 65 20 29 20 73 71 6c 69 74 65 33 44 65  race ) sqlite3De
05d0: 62 75 67 50 72 69 6e 74 66 28 58 2c 59 2c 5a 2c  bugPrintf(X,Y,Z,
05e0: 41 29 0a 23 64 65 66 69 6e 65 20 4f 53 54 52 41  A).#define OSTRA
05f0: 43 45 35 28 58 2c 59 2c 5a 2c 41 2c 42 29 20 69  CE5(X,Y,Z,A,B) i
0600: 66 28 20 73 71 6c 69 74 65 33 5f 6f 73 5f 74 72  f( sqlite3_os_tr
0610: 61 63 65 20 29 20 73 71 6c 69 74 65 33 44 65 62  ace ) sqlite3Deb
0620: 75 67 50 72 69 6e 74 66 28 58 2c 59 2c 5a 2c 41  ugPrintf(X,Y,Z,A
0630: 2c 42 29 0a 23 64 65 66 69 6e 65 20 4f 53 54 52  ,B).#define OSTR
0640: 41 43 45 36 28 58 2c 59 2c 5a 2c 41 2c 42 2c 43  ACE6(X,Y,Z,A,B,C
0650: 29 20 5c 0a 20 20 20 20 69 66 28 73 71 6c 69 74  ) \.    if(sqlit
0660: 65 33 5f 6f 73 5f 74 72 61 63 65 29 20 73 71 6c  e3_os_trace) sql
0670: 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28  ite3DebugPrintf(
0680: 58 2c 59 2c 5a 2c 41 2c 42 2c 43 29 0a 23 64 65  X,Y,Z,A,B,C).#de
0690: 66 69 6e 65 20 4f 53 54 52 41 43 45 37 28 58 2c  fine OSTRACE7(X,
06a0: 59 2c 5a 2c 41 2c 42 2c 43 2c 44 29 20 5c 0a 20  Y,Z,A,B,C,D) \. 
06b0: 20 20 20 69 66 28 73 71 6c 69 74 65 33 5f 6f 73     if(sqlite3_os
06c0: 5f 74 72 61 63 65 29 20 73 71 6c 69 74 65 33 44  _trace) sqlite3D
06d0: 65 62 75 67 50 72 69 6e 74 66 28 58 2c 59 2c 5a  ebugPrintf(X,Y,Z
06e0: 2c 41 2c 42 2c 43 2c 44 29 0a 23 65 6c 73 65 0a  ,A,B,C,D).#else.
06f0: 23 64 65 66 69 6e 65 20 4f 53 54 52 41 43 45 31  #define OSTRACE1
0700: 28 58 29 0a 23 64 65 66 69 6e 65 20 4f 53 54 52  (X).#define OSTR
0710: 41 43 45 32 28 58 2c 59 29 0a 23 64 65 66 69 6e  ACE2(X,Y).#defin
0720: 65 20 4f 53 54 52 41 43 45 33 28 58 2c 59 2c 5a  e OSTRACE3(X,Y,Z
0730: 29 0a 23 64 65 66 69 6e 65 20 4f 53 54 52 41 43  ).#define OSTRAC
0740: 45 34 28 58 2c 59 2c 5a 2c 41 29 0a 23 64 65 66  E4(X,Y,Z,A).#def
0750: 69 6e 65 20 4f 53 54 52 41 43 45 35 28 58 2c 59  ine OSTRACE5(X,Y
0760: 2c 5a 2c 41 2c 42 29 0a 23 64 65 66 69 6e 65 20  ,Z,A,B).#define 
0770: 4f 53 54 52 41 43 45 36 28 58 2c 59 2c 5a 2c 41  OSTRACE6(X,Y,Z,A
0780: 2c 42 2c 43 29 0a 23 64 65 66 69 6e 65 20 4f 53  ,B,C).#define OS
0790: 54 52 41 43 45 37 28 58 2c 59 2c 5a 2c 41 2c 42  TRACE7(X,Y,Z,A,B
07a0: 2c 43 2c 44 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a  ,C,D).#endif../*
07b0: 0a 2a 2a 20 4d 61 63 72 6f 73 20 66 6f 72 20 70  .** Macros for p
07c0: 65 72 66 6f 72 6d 61 6e 63 65 20 74 72 61 63 69  erformance traci
07d0: 6e 67 2e 20 20 4e 6f 72 6d 61 6c 6c 79 20 74 75  ng.  Normally tu
07e0: 72 6e 65 64 20 6f 66 66 2e 20 20 4f 6e 6c 79 20  rned off.  Only 
07f0: 77 6f 72 6b 73 0a 2a 2a 20 6f 6e 20 69 34 38 36  works.** on i486
0800: 20 68 61 72 64 77 61 72 65 2e 0a 2a 2f 0a 23 69   hardware..*/.#i
0810: 66 64 65 66 20 53 51 4c 49 54 45 5f 50 45 52 46  fdef SQLITE_PERF
0820: 4f 52 4d 41 4e 43 45 5f 54 52 41 43 45 0a 5f 5f  ORMANCE_TRACE.__
0830: 69 6e 6c 69 6e 65 5f 5f 20 75 6e 73 69 67 6e 65  inline__ unsigne
0840: 64 20 6c 6f 6e 67 20 6c 6f 6e 67 20 69 6e 74 20  d long long int 
0850: 68 77 74 69 6d 65 28 76 6f 69 64 29 7b 0a 20 20  hwtime(void){.  
0860: 75 6e 73 69 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f  unsigned long lo
0870: 6e 67 20 69 6e 74 20 78 3b 0a 20 20 5f 5f 61 73  ng int x;.  __as
0880: 6d 5f 5f 28 22 72 64 74 73 63 5c 6e 5c 74 22 0a  m__("rdtsc\n\t".
0890: 20 20 20 20 20 20 20 20 20 20 22 6d 6f 76 20 25            "mov %
08a0: 25 65 64 78 2c 20 25 25 65 63 78 5c 6e 5c 74 22  %edx, %%ecx\n\t"
08b0: 0a 20 20 20 20 20 20 20 20 20 20 3a 22 3d 41 22  .          :"=A"
08c0: 20 28 78 29 29 3b 0a 20 20 72 65 74 75 72 6e 20   (x));.  return 
08d0: 78 3b 0a 7d 0a 73 74 61 74 69 63 20 75 6e 73 69  x;.}.static unsi
08e0: 67 6e 65 64 20 6c 6f 6e 67 20 6c 6f 6e 67 20 69  gned long long i
08f0: 6e 74 20 67 5f 73 74 61 72 74 3b 0a 73 74 61 74  nt g_start;.stat
0900: 69 63 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  ic unsigned int 
0910: 65 6c 61 70 73 65 3b 0a 23 64 65 66 69 6e 65 20  elapse;.#define 
0920: 54 49 4d 45 52 5f 53 54 41 52 54 20 20 20 20 20  TIMER_START     
0930: 20 20 67 5f 73 74 61 72 74 3d 68 77 74 69 6d 65    g_start=hwtime
0940: 28 29 0a 23 64 65 66 69 6e 65 20 54 49 4d 45 52  ().#define TIMER
0950: 5f 45 4e 44 20 20 20 20 20 20 20 20 20 65 6c 61  _END         ela
0960: 70 73 65 3d 68 77 74 69 6d 65 28 29 2d 67 5f 73  pse=hwtime()-g_s
0970: 74 61 72 74 0a 23 64 65 66 69 6e 65 20 54 49 4d  tart.#define TIM
0980: 45 52 5f 45 4c 41 50 53 45 44 20 20 20 20 20 65  ER_ELAPSED     e
0990: 6c 61 70 73 65 0a 23 65 6c 73 65 0a 23 64 65 66  lapse.#else.#def
09a0: 69 6e 65 20 54 49 4d 45 52 5f 53 54 41 52 54 0a  ine TIMER_START.
09b0: 23 64 65 66 69 6e 65 20 54 49 4d 45 52 5f 45 4e  #define TIMER_EN
09c0: 44 0a 23 64 65 66 69 6e 65 20 54 49 4d 45 52 5f  D.#define TIMER_
09d0: 45 4c 41 50 53 45 44 20 20 20 20 20 30 0a 23 65  ELAPSED     0.#e
09e0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 77  ndif../*.** If w
09f0: 65 20 63 6f 6d 70 69 6c 65 20 77 69 74 68 20 74  e compile with t
0a00: 68 65 20 53 51 4c 49 54 45 5f 54 45 53 54 20 6d  he SQLITE_TEST m
0a10: 61 63 72 6f 20 73 65 74 2c 20 74 68 65 6e 20 74  acro set, then t
0a20: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f  he following blo
0a30: 63 6b 0a 2a 2a 20 6f 66 20 63 6f 64 65 20 77 69  ck.** of code wi
0a40: 6c 6c 20 67 69 76 65 20 75 73 20 74 68 65 20 61  ll give us the a
0a50: 62 69 6c 69 74 79 20 74 6f 20 73 69 6d 75 6c 61  bility to simula
0a60: 74 65 20 61 20 64 69 73 6b 20 49 2f 4f 20 65 72  te a disk I/O er
0a70: 72 6f 72 2e 20 20 54 68 69 73 0a 2a 2a 20 69 73  ror.  This.** is
0a80: 20 75 73 65 64 20 66 6f 72 20 74 65 73 74 69 6e   used for testin
0a90: 67 20 74 68 65 20 49 2f 4f 20 72 65 63 6f 76 65  g the I/O recove
0aa0: 72 79 20 6c 6f 67 69 63 2e 0a 2a 2f 0a 23 69 66  ry logic..*/.#if
0ab0: 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a  def SQLITE_TEST.
0ac0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65  int sqlite3_io_e
0ad0: 72 72 6f 72 5f 68 69 74 20 3d 20 30 3b 0a 69 6e  rror_hit = 0;.in
0ae0: 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72  t sqlite3_io_err
0af0: 6f 72 5f 70 65 6e 64 69 6e 67 20 3d 20 30 3b 0a  or_pending = 0;.
0b00: 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65  int sqlite3_io_e
0b10: 72 72 6f 72 5f 70 65 72 73 69 73 74 20 3d 20 30  rror_persist = 0
0b20: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64 69  ;.int sqlite3_di
0b30: 73 6b 66 75 6c 6c 5f 70 65 6e 64 69 6e 67 20 3d  skfull_pending =
0b40: 20 30 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f   0;.int sqlite3_
0b50: 64 69 73 6b 66 75 6c 6c 20 3d 20 30 3b 0a 23 64  diskfull = 0;.#d
0b60: 65 66 69 6e 65 20 53 69 6d 75 6c 61 74 65 49 4f  efine SimulateIO
0b70: 45 72 72 6f 72 28 43 4f 44 45 29 20 20 5c 0a 20  Error(CODE)  \. 
0b80: 20 69 66 28 20 73 71 6c 69 74 65 33 5f 69 6f 5f   if( sqlite3_io_
0b90: 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67 20 7c 7c  error_pending ||
0ba0: 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f   sqlite3_io_erro
0bb0: 72 5f 68 69 74 20 29 20 5c 0a 20 20 20 20 20 69  r_hit ) \.     i
0bc0: 66 28 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72  f( sqlite3_io_er
0bd0: 72 6f 72 5f 70 65 6e 64 69 6e 67 2d 2d 20 3d 3d  ror_pending-- ==
0be0: 20 31 20 5c 0a 20 20 20 20 20 20 20 20 20 7c 7c   1 \.         ||
0bf0: 20 28 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72   (sqlite3_io_err
0c00: 6f 72 5f 70 65 72 73 69 73 74 20 26 26 20 73 71  or_persist && sq
0c10: 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 68  lite3_io_error_h
0c20: 69 74 29 20 29 20 5c 0a 20 20 20 20 20 20 20 20  it) ) \.        
0c30: 20 20 20 20 20 20 20 20 7b 20 6c 6f 63 61 6c 5f          { local_
0c40: 69 6f 65 72 72 28 29 3b 20 43 4f 44 45 3b 20 7d  ioerr(); CODE; }
0c50: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6c 6f 63  .static void loc
0c60: 61 6c 5f 69 6f 65 72 72 28 29 7b 0a 20 20 49 4f  al_ioerr(){.  IO
0c70: 54 52 41 43 45 28 28 22 49 4f 45 52 52 5c 6e 22  TRACE(("IOERR\n"
0c80: 29 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 69 6f  ));.  sqlite3_io
0c90: 5f 65 72 72 6f 72 5f 68 69 74 20 3d 20 31 3b 0a  _error_hit = 1;.
0ca0: 7d 0a 23 64 65 66 69 6e 65 20 53 69 6d 75 6c 61  }.#define Simula
0cb0: 74 65 44 69 73 6b 66 75 6c 6c 45 72 72 6f 72 28  teDiskfullError(
0cc0: 43 4f 44 45 29 20 5c 0a 20 20 20 69 66 28 20 73  CODE) \.   if( s
0cd0: 71 6c 69 74 65 33 5f 64 69 73 6b 66 75 6c 6c 5f  qlite3_diskfull_
0ce0: 70 65 6e 64 69 6e 67 20 29 7b 20 5c 0a 20 20 20  pending ){ \.   
0cf0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 64 69    if( sqlite3_di
0d00: 73 6b 66 75 6c 6c 5f 70 65 6e 64 69 6e 67 20 3d  skfull_pending =
0d10: 3d 20 31 20 29 7b 20 5c 0a 20 20 20 20 20 20 20  = 1 ){ \.       
0d20: 6c 6f 63 61 6c 5f 69 6f 65 72 72 28 29 3b 20 5c  local_ioerr(); \
0d30: 0a 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  .       sqlite3_
0d40: 64 69 73 6b 66 75 6c 6c 20 3d 20 31 3b 20 5c 0a  diskfull = 1; \.
0d50: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 69         sqlite3_i
0d60: 6f 5f 65 72 72 6f 72 5f 68 69 74 20 3d 20 31 3b  o_error_hit = 1;
0d70: 20 5c 0a 20 20 20 20 20 20 20 43 4f 44 45 3b 20   \.       CODE; 
0d80: 5c 0a 20 20 20 20 20 7d 65 6c 73 65 7b 20 5c 0a  \.     }else{ \.
0d90: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 64         sqlite3_d
0da0: 69 73 6b 66 75 6c 6c 5f 70 65 6e 64 69 6e 67 2d  iskfull_pending-
0db0: 2d 3b 20 5c 0a 20 20 20 20 20 7d 20 5c 0a 20 20  -; \.     } \.  
0dc0: 20 7d 0a 23 65 6c 73 65 0a 23 64 65 66 69 6e 65   }.#else.#define
0dd0: 20 53 69 6d 75 6c 61 74 65 49 4f 45 72 72 6f 72   SimulateIOError
0de0: 28 41 29 0a 23 64 65 66 69 6e 65 20 53 69 6d 75  (A).#define Simu
0df0: 6c 61 74 65 44 69 73 6b 66 75 6c 6c 45 72 72 6f  lateDiskfullErro
0e00: 72 28 41 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  r(A).#endif../*.
0e10: 2a 2a 20 57 68 65 6e 20 74 65 73 74 69 6e 67 2c  ** When testing,
0e20: 20 6b 65 65 70 20 61 20 63 6f 75 6e 74 20 6f 66   keep a count of
0e30: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 6f   the number of o
0e40: 70 65 6e 20 66 69 6c 65 73 2e 0a 2a 2f 0a 23 69  pen files..*/.#i
0e50: 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54  fdef SQLITE_TEST
0e60: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6f 70 65  .int sqlite3_ope
0e70: 6e 5f 66 69 6c 65 5f 63 6f 75 6e 74 20 3d 20 30  n_file_count = 0
0e80: 3b 0a 23 64 65 66 69 6e 65 20 4f 70 65 6e 43 6f  ;.#define OpenCo
0e90: 75 6e 74 65 72 28 58 29 20 20 73 71 6c 69 74 65  unter(X)  sqlite
0ea0: 33 5f 6f 70 65 6e 5f 66 69 6c 65 5f 63 6f 75 6e  3_open_file_coun
0eb0: 74 2b 3d 28 58 29 0a 23 65 6c 73 65 0a 23 64 65  t+=(X).#else.#de
0ec0: 66 69 6e 65 20 4f 70 65 6e 43 6f 75 6e 74 65 72  fine OpenCounter
0ed0: 28 58 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a  (X).#endif../*.*
0ee0: 2a 20 73 71 6c 69 74 65 33 47 65 6e 65 72 69 63  * sqlite3Generic
0ef0: 4d 61 6c 6c 6f 63 0a 2a 2a 20 73 71 6c 69 74 65  Malloc.** sqlite
0f00: 33 47 65 6e 65 72 69 63 52 65 61 6c 6c 6f 63 0a  3GenericRealloc.
0f10: 2a 2a 20 73 71 6c 69 74 65 33 47 65 6e 65 72 69  ** sqlite3Generi
0f20: 63 4f 73 46 72 65 65 0a 2a 2a 20 73 71 6c 69 74  cOsFree.** sqlit
0f30: 65 33 47 65 6e 65 72 69 63 41 6c 6c 6f 63 61 74  e3GenericAllocat
0f40: 69 6f 6e 53 69 7a 65 0a 2a 2a 0a 2a 2a 20 49 6d  ionSize.**.** Im
0f50: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
0f60: 74 68 65 20 6f 73 20 6c 65 76 65 6c 20 64 79 6e  the os level dyn
0f70: 61 6d 69 63 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f  amic memory allo
0f80: 63 61 74 69 6f 6e 20 69 6e 74 65 72 66 61 63 65  cation interface
0f90: 20 69 6e 20 74 65 72 6d 73 0a 2a 2a 20 6f 66 20   in terms.** of 
0fa0: 74 68 65 20 73 74 61 6e 64 61 72 64 20 6d 61 6c  the standard mal
0fb0: 6c 6f 63 28 29 2c 20 72 65 61 6c 6c 6f 63 28 29  loc(), realloc()
0fc0: 20 61 6e 64 20 66 72 65 65 28 29 20 66 6f 75 6e   and free() foun
0fd0: 64 20 69 6e 20 6d 61 6e 79 20 6f 70 65 72 61 74  d in many operat
0fe0: 69 6e 67 0a 2a 2a 20 73 79 73 74 65 6d 73 2e 20  ing.** systems. 
0ff0: 4e 6f 20 72 6f 63 6b 65 74 20 73 63 69 65 6e 63  No rocket scienc
1000: 65 20 68 65 72 65 2e 0a 2a 2a 0a 2a 2a 20 54 68  e here..**.** Th
1010: 65 72 65 20 61 72 65 20 74 77 6f 20 76 65 72 73  ere are two vers
1020: 69 6f 6e 73 20 6f 66 20 74 68 65 73 65 20 66 6f  ions of these fo
1030: 75 72 20 66 75 6e 63 74 69 6f 6e 73 20 68 65 72  ur functions her
1040: 65 2e 20 54 68 65 20 76 65 72 73 69 6f 6e 0a 2a  e. The version.*
1050: 2a 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 68 65  * implemented he
1060: 72 65 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20  re is only used 
1070: 69 66 20 6d 65 6d 6f 72 79 2d 6d 61 6e 61 67 65  if memory-manage
1080: 6d 65 6e 74 20 6f 72 20 6d 65 6d 6f 72 79 2d 64  ment or memory-d
1090: 65 62 75 67 67 69 6e 67 20 69 73 0a 2a 2a 20 65  ebugging is.** e
10a0: 6e 61 62 6c 65 64 2e 20 54 68 69 73 20 76 65 72  nabled. This ver
10b0: 73 69 6f 6e 20 61 6c 6c 6f 63 61 74 65 73 20 61  sion allocates a
10c0: 6e 20 65 78 74 72 61 20 38 2d 62 79 74 65 73 20  n extra 8-bytes 
10d0: 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67  at the beginning
10e0: 20 6f 66 20 65 61 63 68 0a 2a 2a 20 62 6c 6f 63   of each.** bloc
10f0: 6b 20 61 6e 64 20 73 74 6f 72 65 73 20 74 68 65  k and stores the
1100: 20 73 69 7a 65 20 6f 66 20 74 68 65 20 61 6c 6c   size of the all
1110: 6f 63 61 74 69 6f 6e 20 74 68 65 72 65 2e 0a 2a  ocation there..*
1120: 2a 0a 2a 2a 20 49 66 20 6e 65 69 74 68 65 72 20  *.** If neither 
1130: 6d 65 6d 6f 72 79 2d 6d 61 6e 61 67 65 6d 65 6e  memory-managemen
1140: 74 20 6f 72 20 64 65 62 75 67 67 69 6e 67 20 69  t or debugging i
1150: 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 20 73  s enabled, the s
1160: 65 63 6f 6e 64 0a 2a 2a 20 73 65 74 20 6f 66 20  econd.** set of 
1170: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20  implementations 
1180: 69 73 20 75 73 65 64 20 69 6e 73 74 65 61 64 2e  is used instead.
1190: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28  .*/.#if defined(
11a0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45  SQLITE_ENABLE_ME
11b0: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 29  MORY_MANAGEMENT)
11c0: 20 7c 7c 20 64 65 66 69 6e 65 64 20 28 53 51 4c   || defined (SQL
11d0: 49 54 45 5f 4d 45 4d 44 45 42 55 47 29 0a 76 6f  ITE_MEMDEBUG).vo
11e0: 69 64 20 2a 73 71 6c 69 74 65 33 47 65 6e 65 72  id *sqlite3Gener
11f0: 69 63 4d 61 6c 6c 6f 63 28 69 6e 74 20 6e 29 7b  icMalloc(int n){
1200: 0a 20 20 63 68 61 72 20 2a 70 20 3d 20 28 63 68  .  char *p = (ch
1210: 61 72 20 2a 29 6d 61 6c 6c 6f 63 28 6e 2b 38 29  ar *)malloc(n+8)
1220: 3b 0a 20 20 61 73 73 65 72 74 28 6e 3e 30 29 3b  ;.  assert(n>0);
1230: 0a 20 20 61 73 73 65 72 74 28 73 69 7a 65 6f 66  .  assert(sizeof
1240: 28 69 6e 74 29 3c 3d 38 29 3b 0a 20 20 69 66 28  (int)<=8);.  if(
1250: 20 70 20 29 7b 0a 20 20 20 20 2a 28 69 6e 74 20   p ){.    *(int 
1260: 2a 29 70 20 3d 20 6e 3b 0a 20 20 20 20 70 20 2b  *)p = n;.    p +
1270: 3d 20 38 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  = 8;.  }.  retur
1280: 6e 20 28 76 6f 69 64 20 2a 29 70 3b 0a 7d 0a 76  n (void *)p;.}.v
1290: 6f 69 64 20 2a 73 71 6c 69 74 65 33 47 65 6e 65  oid *sqlite3Gene
12a0: 72 69 63 52 65 61 6c 6c 6f 63 28 76 6f 69 64 20  ricRealloc(void 
12b0: 2a 70 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 63 68  *p, int n){.  ch
12c0: 61 72 20 2a 70 32 20 3d 20 28 28 63 68 61 72 20  ar *p2 = ((char 
12d0: 2a 29 70 20 2d 20 38 29 3b 0a 20 20 61 73 73 65  *)p - 8);.  asse
12e0: 72 74 28 6e 3e 30 29 3b 0a 20 20 70 32 20 3d 20  rt(n>0);.  p2 = 
12f0: 28 63 68 61 72 2a 29 72 65 61 6c 6c 6f 63 28 70  (char*)realloc(p
1300: 32 2c 20 6e 2b 38 29 3b 0a 20 20 69 66 28 20 70  2, n+8);.  if( p
1310: 32 20 29 7b 0a 20 20 20 20 2a 28 69 6e 74 20 2a  2 ){.    *(int *
1320: 29 70 32 20 3d 20 6e 3b 0a 20 20 20 20 70 32 20  )p2 = n;.    p2 
1330: 2b 3d 20 38 3b 0a 20 20 7d 0a 20 20 72 65 74 75  += 8;.  }.  retu
1340: 72 6e 20 28 76 6f 69 64 20 2a 29 70 32 3b 0a 7d  rn (void *)p2;.}
1350: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 47 65 6e  .void sqlite3Gen
1360: 65 72 69 63 46 72 65 65 28 76 6f 69 64 20 2a 70  ericFree(void *p
1370: 29 7b 0a 20 20 61 73 73 65 72 74 28 70 29 3b 0a  ){.  assert(p);.
1380: 20 20 66 72 65 65 28 28 76 6f 69 64 20 2a 29 28    free((void *)(
1390: 28 63 68 61 72 20 2a 29 70 20 2d 20 38 29 29 3b  (char *)p - 8));
13a0: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 47 65  .}.int sqlite3Ge
13b0: 6e 65 72 69 63 41 6c 6c 6f 63 61 74 69 6f 6e 53  nericAllocationS
13c0: 69 7a 65 28 76 6f 69 64 20 2a 70 29 7b 0a 20 20  ize(void *p){.  
13d0: 72 65 74 75 72 6e 20 70 20 3f 20 2a 28 69 6e 74  return p ? *(int
13e0: 20 2a 29 28 28 63 68 61 72 20 2a 29 70 20 2d 20   *)((char *)p - 
13f0: 38 29 20 3a 20 30 3b 0a 7d 0a 23 65 6c 73 65 0a  8) : 0;.}.#else.
1400: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 47 65 6e  void *sqlite3Gen
1410: 65 72 69 63 4d 61 6c 6c 6f 63 28 69 6e 74 20 6e  ericMalloc(int n
1420: 29 7b 0a 20 20 63 68 61 72 20 2a 70 20 3d 20 28  ){.  char *p = (
1430: 63 68 61 72 20 2a 29 6d 61 6c 6c 6f 63 28 6e 29  char *)malloc(n)
1440: 3b 0a 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64  ;.  return (void
1450: 20 2a 29 70 3b 0a 7d 0a 76 6f 69 64 20 2a 73 71   *)p;.}.void *sq
1460: 6c 69 74 65 33 47 65 6e 65 72 69 63 52 65 61 6c  lite3GenericReal
1470: 6c 6f 63 28 76 6f 69 64 20 2a 70 2c 20 69 6e 74  loc(void *p, int
1480: 20 6e 29 7b 0a 20 20 61 73 73 65 72 74 28 6e 3e   n){.  assert(n>
1490: 30 29 3b 0a 20 20 70 20 3d 20 72 65 61 6c 6c 6f  0);.  p = reallo
14a0: 63 28 70 2c 20 6e 29 3b 0a 20 20 72 65 74 75 72  c(p, n);.  retur
14b0: 6e 20 70 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69  n p;.}.void sqli
14c0: 74 65 33 47 65 6e 65 72 69 63 46 72 65 65 28 76  te3GenericFree(v
14d0: 6f 69 64 20 2a 70 29 7b 0a 20 20 61 73 73 65 72  oid *p){.  asser
14e0: 74 28 70 29 3b 0a 20 20 66 72 65 65 28 70 29 3b  t(p);.  free(p);
14f0: 0a 7d 0a 2f 2a 20 4e 65 76 65 72 20 61 63 74 75  .}./* Never actu
1500: 61 6c 6c 79 20 75 73 65 64 2c 20 62 75 74 20 6e  ally used, but n
1510: 65 65 64 65 64 20 66 6f 72 20 74 68 65 20 6c 69  eeded for the li
1520: 6e 6b 65 72 20 2a 2f 0a 69 6e 74 20 73 71 6c 69  nker */.int sqli
1530: 74 65 33 47 65 6e 65 72 69 63 41 6c 6c 6f 63 61  te3GenericAlloca
1540: 74 69 6f 6e 53 69 7a 65 28 76 6f 69 64 20 2a 70  tionSize(void *p
1550: 29 7b 20 72 65 74 75 72 6e 20 30 3b 20 7d 0a 23  ){ return 0; }.#
1560: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65  endif../*.** The
1570: 20 64 65 66 61 75 6c 74 20 73 69 7a 65 20 6f 66   default size of
1580: 20 61 20 64 69 73 6b 20 73 65 63 74 6f 72 0a 2a   a disk sector.*
1590: 2f 0a 23 69 66 6e 64 65 66 20 50 41 47 45 52 5f  /.#ifndef PAGER_
15a0: 53 45 43 54 4f 52 5f 53 49 5a 45 0a 23 20 64 65  SECTOR_SIZE.# de
15b0: 66 69 6e 65 20 50 41 47 45 52 5f 53 45 43 54 4f  fine PAGER_SECTO
15c0: 52 5f 53 49 5a 45 20 35 31 32 0a 23 65 6e 64 69  R_SIZE 512.#endi
15d0: 66 0a                                            f.