1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/persistentdata/persistentstorage/sqlite3api/SQLite/fault.c	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,91 @@
     1.4 +/*
     1.5 +** 2008 Jan 22
     1.6 +**
     1.7 +** The author disclaims copyright to this source code.  In place of
     1.8 +** a legal notice, here is a blessing:
     1.9 +**
    1.10 +**    May you do good and not evil.
    1.11 +**    May you find forgiveness for yourself and forgive others.
    1.12 +**    May you share freely, never taking more than you give.
    1.13 +**
    1.14 +*************************************************************************
    1.15 +**
    1.16 +** $Id: fault.c,v 1.11 2008/09/02 00:52:52 drh Exp $
    1.17 +*/
    1.18 +
    1.19 +/*
    1.20 +** This file contains code to support the concept of "benign" 
    1.21 +** malloc failures (when the xMalloc() or xRealloc() method of the
    1.22 +** sqlite3_mem_methods structure fails to allocate a block of memory
    1.23 +** and returns 0). 
    1.24 +**
    1.25 +** Most malloc failures are non-benign. After they occur, SQLite
    1.26 +** abandons the current operation and returns an error code (usually
    1.27 +** SQLITE_NOMEM) to the user. However, sometimes a fault is not necessarily
    1.28 +** fatal. For example, if a malloc fails while resizing a hash table, this 
    1.29 +** is completely recoverable simply by not carrying out the resize. The 
    1.30 +** hash table will continue to function normally.  So a malloc failure 
    1.31 +** during a hash table resize is a benign fault.
    1.32 +*/
    1.33 +
    1.34 +#include "sqliteInt.h"
    1.35 +
    1.36 +#ifndef SQLITE_OMIT_BUILTIN_TEST
    1.37 +
    1.38 +/*
    1.39 +** Global variables.
    1.40 +*/
    1.41 +typedef struct BenignMallocHooks BenignMallocHooks;
    1.42 +static SQLITE_WSD struct BenignMallocHooks {
    1.43 +  void (*xBenignBegin)(void);
    1.44 +  void (*xBenignEnd)(void);
    1.45 +} sqlite3Hooks = { 0, 0 };
    1.46 +
    1.47 +/* The "wsdHooks" macro will resolve to the appropriate BenignMallocHooks
    1.48 +** structure.  If writable static data is unsupported on the target,
    1.49 +** we have to locate the state vector at run-time.  In the more common
    1.50 +** case where writable static data is supported, wsdHooks can refer directly
    1.51 +** to the "sqlite3Hooks" state vector declared above.
    1.52 +*/
    1.53 +#ifdef SQLITE_OMIT_WSD
    1.54 +# define wsdHooksInit \
    1.55 +  BenignMallocHooks *x = &GLOBAL(BenignMallocHooks,sqlite3Hooks)
    1.56 +# define wsdHooks x[0]
    1.57 +#else
    1.58 +# define wsdHooksInit
    1.59 +# define wsdHooks sqlite3Hooks
    1.60 +#endif
    1.61 +
    1.62 +
    1.63 +/*
    1.64 +** Register hooks to call when sqlite3BeginBenignMalloc() and
    1.65 +** sqlite3EndBenignMalloc() are called, respectively.
    1.66 +*/
    1.67 +void sqlite3BenignMallocHooks(
    1.68 +  void (*xBenignBegin)(void),
    1.69 +  void (*xBenignEnd)(void)
    1.70 +){
    1.71 +  wsdHooksInit;
    1.72 +  wsdHooks.xBenignBegin = xBenignBegin;
    1.73 +  wsdHooks.xBenignEnd = xBenignEnd;
    1.74 +}
    1.75 +
    1.76 +/*
    1.77 +** This (sqlite3EndBenignMalloc()) is called by SQLite code to indicate that
    1.78 +** subsequent malloc failures are benign. A call to sqlite3EndBenignMalloc()
    1.79 +** indicates that subsequent malloc failures are non-benign.
    1.80 +*/
    1.81 +void sqlite3BeginBenignMalloc(void){
    1.82 +  wsdHooksInit;
    1.83 +  if( wsdHooks.xBenignBegin ){
    1.84 +    wsdHooks.xBenignBegin();
    1.85 +  }
    1.86 +}
    1.87 +void sqlite3EndBenignMalloc(void){
    1.88 +  wsdHooksInit;
    1.89 +  if( wsdHooks.xBenignEnd ){
    1.90 +    wsdHooks.xBenignEnd();
    1.91 +  }
    1.92 +}
    1.93 +
    1.94 +#endif   /* #ifndef SQLITE_OMIT_BUILTIN_TEST */