/ Hex Artifact Content
Login

Artifact abdb9a191a367793268fe553d25bab894e986a0e:


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 23 69 66 6e 64 65 66 20 5f 4f 53 5f  .*/.#ifndef _OS_
0290: 43 4f 4d 4d 4f 4e 5f 48 5f 0a 23 64 65 66 69 6e  COMMON_H_.#defin
02a0: 65 20 5f 4f 53 5f 43 4f 4d 4d 4f 4e 5f 48 5f 0a  e _OS_COMMON_H_.
02b0: 0a 2f 2a 0a 2a 2a 20 41 74 20 6c 65 61 73 74 20  ./*.** At least 
02c0: 74 77 6f 20 62 75 67 73 20 68 61 76 65 20 73 6c  two bugs have sl
02d0: 69 70 70 65 64 20 69 6e 20 62 65 63 61 75 73 65  ipped in because
02e0: 20 77 65 20 63 68 61 6e 67 65 64 20 74 68 65 20   we changed the 
02f0: 4d 45 4d 4f 52 59 5f 44 45 42 55 47 0a 2a 2a 20  MEMORY_DEBUG.** 
0300: 6d 61 63 72 6f 20 74 6f 20 53 51 4c 49 54 45 5f  macro to SQLITE_
0310: 44 45 42 55 47 20 61 6e 64 20 73 6f 6d 65 20 6f  DEBUG and some o
0320: 6c 64 65 72 20 6d 61 6b 65 66 69 6c 65 73 20 68  lder makefiles h
0330: 61 76 65 20 6e 6f 74 20 79 65 74 20 6d 61 64 65  ave not yet made
0340: 20 74 68 65 0a 2a 2a 20 73 77 69 74 63 68 2e 20   the.** switch. 
0350: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63   The following c
0360: 6f 64 65 20 73 68 6f 75 6c 64 20 63 61 74 63 68  ode should catch
0370: 20 74 68 69 73 20 70 72 6f 62 6c 65 6d 20 61 74   this problem at
0380: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2e 0a 2a   compile-time..*
0390: 2f 0a 23 69 66 64 65 66 20 4d 45 4d 4f 52 59 5f  /.#ifdef MEMORY_
03a0: 44 45 42 55 47 0a 23 20 65 72 72 6f 72 20 22 54  DEBUG.# error "T
03b0: 68 65 20 4d 45 4d 4f 52 59 5f 44 45 42 55 47 20  he MEMORY_DEBUG 
03c0: 6d 61 63 72 6f 20 69 73 20 6f 62 73 6f 6c 65 74  macro is obsolet
03d0: 65 2e 20 20 55 73 65 20 53 51 4c 49 54 45 5f 44  e.  Use SQLITE_D
03e0: 45 42 55 47 20 69 6e 73 74 65 61 64 2e 22 0a 23  EBUG instead.".#
03f0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63  endif../*.** Mac
0400: 72 6f 73 20 66 6f 72 20 70 65 72 66 6f 72 6d 61  ros for performa
0410: 6e 63 65 20 74 72 61 63 69 6e 67 2e 20 20 4e 6f  nce tracing.  No
0420: 72 6d 61 6c 6c 79 20 74 75 72 6e 65 64 20 6f 66  rmally turned of
0430: 66 2e 20 20 4f 6e 6c 79 20 77 6f 72 6b 73 0a 2a  f.  Only works.*
0440: 2a 20 6f 6e 20 69 34 38 36 20 68 61 72 64 77 61  * on i486 hardwa
0450: 72 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51  re..*/.#ifdef SQ
0460: 4c 49 54 45 5f 50 45 52 46 4f 52 4d 41 4e 43 45  LITE_PERFORMANCE
0470: 5f 54 52 41 43 45 0a 0a 2f 2a 20 0a 2a 2a 20 68  _TRACE../* .** h
0480: 77 74 69 6d 65 2e 68 20 63 6f 6e 74 61 69 6e 73  wtime.h contains
0490: 20 69 6e 6c 69 6e 65 20 61 73 73 65 6d 62 6c 65   inline assemble
04a0: 72 20 63 6f 64 65 20 66 6f 72 20 69 6d 70 6c 65  r code for imple
04b0: 6d 65 6e 74 69 6e 67 20 0a 2a 2a 20 68 69 67 68  menting .** high
04c0: 2d 70 65 72 66 6f 72 6d 61 6e 63 65 20 74 69 6d  -performance tim
04d0: 69 6e 67 20 72 6f 75 74 69 6e 65 73 2e 0a 2a 2f  ing routines..*/
04e0: 0a 23 69 6e 63 6c 75 64 65 20 22 68 77 74 69 6d  .#include "hwtim
04f0: 65 2e 68 22 0a 0a 73 74 61 74 69 63 20 73 71 6c  e.h"..static sql
0500: 69 74 65 5f 75 69 6e 74 36 34 20 67 5f 73 74 61  ite_uint64 g_sta
0510: 72 74 3b 0a 73 74 61 74 69 63 20 73 71 6c 69 74  rt;.static sqlit
0520: 65 5f 75 69 6e 74 36 34 20 67 5f 65 6c 61 70 73  e_uint64 g_elaps
0530: 65 64 3b 0a 23 64 65 66 69 6e 65 20 54 49 4d 45  ed;.#define TIME
0540: 52 5f 53 54 41 52 54 20 20 20 20 20 20 20 67 5f  R_START       g_
0550: 73 74 61 72 74 3d 73 71 6c 69 74 65 33 48 77 74  start=sqlite3Hwt
0560: 69 6d 65 28 29 0a 23 64 65 66 69 6e 65 20 54 49  ime().#define TI
0570: 4d 45 52 5f 45 4e 44 20 20 20 20 20 20 20 20 20  MER_END         
0580: 67 5f 65 6c 61 70 73 65 64 3d 73 71 6c 69 74 65  g_elapsed=sqlite
0590: 33 48 77 74 69 6d 65 28 29 2d 67 5f 73 74 61 72  3Hwtime()-g_star
05a0: 74 0a 23 64 65 66 69 6e 65 20 54 49 4d 45 52 5f  t.#define TIMER_
05b0: 45 4c 41 50 53 45 44 20 20 20 20 20 67 5f 65 6c  ELAPSED     g_el
05c0: 61 70 73 65 64 0a 23 65 6c 73 65 0a 23 64 65 66  apsed.#else.#def
05d0: 69 6e 65 20 54 49 4d 45 52 5f 53 54 41 52 54 0a  ine TIMER_START.
05e0: 23 64 65 66 69 6e 65 20 54 49 4d 45 52 5f 45 4e  #define TIMER_EN
05f0: 44 0a 23 64 65 66 69 6e 65 20 54 49 4d 45 52 5f  D.#define TIMER_
0600: 45 4c 41 50 53 45 44 20 20 20 20 20 28 28 73 71  ELAPSED     ((sq
0610: 6c 69 74 65 5f 75 69 6e 74 36 34 29 30 29 0a 23  lite_uint64)0).#
0620: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20  endif../*.** If 
0630: 77 65 20 63 6f 6d 70 69 6c 65 20 77 69 74 68 20  we compile with 
0640: 74 68 65 20 53 51 4c 49 54 45 5f 54 45 53 54 20  the SQLITE_TEST 
0650: 6d 61 63 72 6f 20 73 65 74 2c 20 74 68 65 6e 20  macro set, then 
0660: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c  the following bl
0670: 6f 63 6b 0a 2a 2a 20 6f 66 20 63 6f 64 65 20 77  ock.** of code w
0680: 69 6c 6c 20 67 69 76 65 20 75 73 20 74 68 65 20  ill give us the 
0690: 61 62 69 6c 69 74 79 20 74 6f 20 73 69 6d 75 6c  ability to simul
06a0: 61 74 65 20 61 20 64 69 73 6b 20 49 2f 4f 20 65  ate a disk I/O e
06b0: 72 72 6f 72 2e 20 20 54 68 69 73 0a 2a 2a 20 69  rror.  This.** i
06c0: 73 20 75 73 65 64 20 66 6f 72 20 74 65 73 74 69  s used for testi
06d0: 6e 67 20 74 68 65 20 49 2f 4f 20 72 65 63 6f 76  ng the I/O recov
06e0: 65 72 79 20 6c 6f 67 69 63 2e 0a 2a 2f 0a 23 69  ery logic..*/.#i
06f0: 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54  fdef SQLITE_TEST
0700: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f  .int sqlite3_io_
0710: 65 72 72 6f 72 5f 68 69 74 20 3d 20 30 3b 20 20  error_hit = 0;  
0720: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 74            /* Tot
0730: 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 49 2f 4f  al number of I/O
0740: 20 45 72 72 6f 72 73 20 2a 2f 0a 69 6e 74 20 73   Errors */.int s
0750: 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f  qlite3_io_error_
0760: 68 61 72 64 68 69 74 20 3d 20 30 3b 20 20 20 20  hardhit = 0;    
0770: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
0780: 20 6e 6f 6e 2d 62 65 6e 69 67 6e 20 65 72 72 6f   non-benign erro
0790: 72 73 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  rs */.int sqlite
07a0: 33 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69  3_io_error_pendi
07b0: 6e 67 20 3d 20 30 3b 20 20 20 20 20 20 20 20 2f  ng = 0;        /
07c0: 2a 20 43 6f 75 6e 74 20 64 6f 77 6e 20 74 6f 20  * Count down to 
07d0: 66 69 72 73 74 20 49 2f 4f 20 65 72 72 6f 72 20  first I/O error 
07e0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 69  */.int sqlite3_i
07f0: 6f 5f 65 72 72 6f 72 5f 70 65 72 73 69 73 74 20  o_error_persist 
0800: 3d 20 30 3b 20 20 20 20 20 20 20 20 2f 2a 20 54  = 0;        /* T
0810: 72 75 65 20 69 66 20 49 2f 4f 20 65 72 72 6f 72  rue if I/O error
0820: 73 20 70 65 72 73 69 73 74 20 2a 2f 0a 69 6e 74  s persist */.int
0830: 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f   sqlite3_io_erro
0840: 72 5f 62 65 6e 69 67 6e 20 3d 20 30 3b 20 20 20  r_benign = 0;   
0850: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
0860: 20 65 72 72 6f 72 73 20 61 72 65 20 62 65 6e 69   errors are beni
0870: 67 6e 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  gn */.int sqlite
0880: 33 5f 64 69 73 6b 66 75 6c 6c 5f 70 65 6e 64 69  3_diskfull_pendi
0890: 6e 67 20 3d 20 30 3b 0a 69 6e 74 20 73 71 6c 69  ng = 0;.int sqli
08a0: 74 65 33 5f 64 69 73 6b 66 75 6c 6c 20 3d 20 30  te3_diskfull = 0
08b0: 3b 0a 23 64 65 66 69 6e 65 20 53 69 6d 75 6c 61  ;.#define Simula
08c0: 74 65 49 4f 45 72 72 6f 72 42 65 6e 69 67 6e 28  teIOErrorBenign(
08d0: 58 29 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72  X) sqlite3_io_er
08e0: 72 6f 72 5f 62 65 6e 69 67 6e 3d 28 58 29 0a 23  ror_benign=(X).#
08f0: 64 65 66 69 6e 65 20 53 69 6d 75 6c 61 74 65 49  define SimulateI
0900: 4f 45 72 72 6f 72 28 43 4f 44 45 29 20 20 5c 0a  OError(CODE)  \.
0910: 20 20 69 66 28 20 28 73 71 6c 69 74 65 33 5f 69    if( (sqlite3_i
0920: 6f 5f 65 72 72 6f 72 5f 70 65 72 73 69 73 74 20  o_error_persist 
0930: 26 26 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72  && sqlite3_io_er
0940: 72 6f 72 5f 68 69 74 29 20 5c 0a 20 20 20 20 20  ror_hit) \.     
0950: 20 20 7c 7c 20 73 71 6c 69 74 65 33 5f 69 6f 5f    || sqlite3_io_
0960: 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67 2d 2d 20  error_pending-- 
0970: 3d 3d 20 31 20 29 20 20 5c 0a 20 20 20 20 20 20  == 1 )  \.      
0980: 20 20 20 20 20 20 20 20 7b 20 6c 6f 63 61 6c 5f          { local_
0990: 69 6f 65 72 72 28 29 3b 20 43 4f 44 45 3b 20 7d  ioerr(); CODE; }
09a0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6c 6f 63  .static void loc
09b0: 61 6c 5f 69 6f 65 72 72 28 29 7b 0a 20 20 49 4f  al_ioerr(){.  IO
09c0: 54 52 41 43 45 28 28 22 49 4f 45 52 52 5c 6e 22  TRACE(("IOERR\n"
09d0: 29 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 69 6f  ));.  sqlite3_io
09e0: 5f 65 72 72 6f 72 5f 68 69 74 2b 2b 3b 0a 20 20  _error_hit++;.  
09f0: 69 66 28 20 21 73 71 6c 69 74 65 33 5f 69 6f 5f  if( !sqlite3_io_
0a00: 65 72 72 6f 72 5f 62 65 6e 69 67 6e 20 29 20 73  error_benign ) s
0a10: 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f  qlite3_io_error_
0a20: 68 61 72 64 68 69 74 2b 2b 3b 0a 7d 0a 23 64 65  hardhit++;.}.#de
0a30: 66 69 6e 65 20 53 69 6d 75 6c 61 74 65 44 69 73  fine SimulateDis
0a40: 6b 66 75 6c 6c 45 72 72 6f 72 28 43 4f 44 45 29  kfullError(CODE)
0a50: 20 5c 0a 20 20 20 69 66 28 20 73 71 6c 69 74 65   \.   if( sqlite
0a60: 33 5f 64 69 73 6b 66 75 6c 6c 5f 70 65 6e 64 69  3_diskfull_pendi
0a70: 6e 67 20 29 7b 20 5c 0a 20 20 20 20 20 69 66 28  ng ){ \.     if(
0a80: 20 73 71 6c 69 74 65 33 5f 64 69 73 6b 66 75 6c   sqlite3_diskful
0a90: 6c 5f 70 65 6e 64 69 6e 67 20 3d 3d 20 31 20 29  l_pending == 1 )
0aa0: 7b 20 5c 0a 20 20 20 20 20 20 20 6c 6f 63 61 6c  { \.       local
0ab0: 5f 69 6f 65 72 72 28 29 3b 20 5c 0a 20 20 20 20  _ioerr(); \.    
0ac0: 20 20 20 73 71 6c 69 74 65 33 5f 64 69 73 6b 66     sqlite3_diskf
0ad0: 75 6c 6c 20 3d 20 31 3b 20 5c 0a 20 20 20 20 20  ull = 1; \.     
0ae0: 20 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72    sqlite3_io_err
0af0: 6f 72 5f 68 69 74 20 3d 20 31 3b 20 5c 0a 20 20  or_hit = 1; \.  
0b00: 20 20 20 20 20 43 4f 44 45 3b 20 5c 0a 20 20 20       CODE; \.   
0b10: 20 20 7d 65 6c 73 65 7b 20 5c 0a 20 20 20 20 20    }else{ \.     
0b20: 20 20 73 71 6c 69 74 65 33 5f 64 69 73 6b 66 75    sqlite3_diskfu
0b30: 6c 6c 5f 70 65 6e 64 69 6e 67 2d 2d 3b 20 5c 0a  ll_pending--; \.
0b40: 20 20 20 20 20 7d 20 5c 0a 20 20 20 7d 0a 23 65       } \.   }.#e
0b50: 6c 73 65 0a 23 64 65 66 69 6e 65 20 53 69 6d 75  lse.#define Simu
0b60: 6c 61 74 65 49 4f 45 72 72 6f 72 42 65 6e 69 67  lateIOErrorBenig
0b70: 6e 28 58 29 0a 23 64 65 66 69 6e 65 20 53 69 6d  n(X).#define Sim
0b80: 75 6c 61 74 65 49 4f 45 72 72 6f 72 28 41 29 0a  ulateIOError(A).
0b90: 23 64 65 66 69 6e 65 20 53 69 6d 75 6c 61 74 65  #define Simulate
0ba0: 44 69 73 6b 66 75 6c 6c 45 72 72 6f 72 28 41 29  DiskfullError(A)
0bb0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 57  .#endif../*.** W
0bc0: 68 65 6e 20 74 65 73 74 69 6e 67 2c 20 6b 65 65  hen testing, kee
0bd0: 70 20 61 20 63 6f 75 6e 74 20 6f 66 20 74 68 65  p a count of the
0be0: 20 6e 75 6d 62 65 72 20 6f 66 20 6f 70 65 6e 20   number of open 
0bf0: 66 69 6c 65 73 2e 0a 2a 2f 0a 23 69 66 64 65 66  files..*/.#ifdef
0c00: 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 69 6e 74   SQLITE_TEST.int
0c10: 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 66 69   sqlite3_open_fi
0c20: 6c 65 5f 63 6f 75 6e 74 20 3d 20 30 3b 0a 23 64  le_count = 0;.#d
0c30: 65 66 69 6e 65 20 4f 70 65 6e 43 6f 75 6e 74 65  efine OpenCounte
0c40: 72 28 58 29 20 20 73 71 6c 69 74 65 33 5f 6f 70  r(X)  sqlite3_op
0c50: 65 6e 5f 66 69 6c 65 5f 63 6f 75 6e 74 2b 3d 28  en_file_count+=(
0c60: 58 29 0a 23 65 6c 73 65 0a 23 64 65 66 69 6e 65  X).#else.#define
0c70: 20 4f 70 65 6e 43 6f 75 6e 74 65 72 28 58 29 0a   OpenCounter(X).
0c80: 23 65 6e 64 69 66 0a 0a 23 65 6e 64 69 66 20 2f  #endif..#endif /
0c90: 2a 20 21 64 65 66 69 6e 65 64 28 5f 4f 53 5f 43  * !defined(_OS_C
0ca0: 4f 4d 4d 4f 4e 5f 48 5f 29 20 2a 2f 0a           OMMON_H_) */.