1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/persistentdata/persistentstorage/sql/SQLite/fault.c	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,71 @@
     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.10 2008/06/22 12:37:58 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 +static struct BenignMallocHooks {
    1.42 +  void (*xBenignBegin)(void);
    1.43 +  void (*xBenignEnd)(void);
    1.44 +} hooks;
    1.45 +
    1.46 +/*
    1.47 +** Register hooks to call when sqlite3BeginBenignMalloc() and
    1.48 +** sqlite3EndBenignMalloc() are called, respectively.
    1.49 +*/
    1.50 +void sqlite3BenignMallocHooks(
    1.51 +  void (*xBenignBegin)(void),
    1.52 +  void (*xBenignEnd)(void)
    1.53 +){
    1.54 +  hooks.xBenignBegin = xBenignBegin;
    1.55 +  hooks.xBenignEnd = xBenignEnd;
    1.56 +}
    1.57 +
    1.58 +/*
    1.59 +** This (sqlite3EndBenignMalloc()) is called by SQLite code to indicate that
    1.60 +** subsequent malloc failures are benign. A call to sqlite3EndBenignMalloc()
    1.61 +** indicates that subsequent malloc failures are non-benign.
    1.62 +*/
    1.63 +void sqlite3BeginBenignMalloc(void){
    1.64 +  if( hooks.xBenignBegin ){
    1.65 +    hooks.xBenignBegin();
    1.66 +  }
    1.67 +}
    1.68 +void sqlite3EndBenignMalloc(void){
    1.69 +  if( hooks.xBenignEnd ){
    1.70 +    hooks.xBenignEnd();
    1.71 +  }
    1.72 +}
    1.73 +
    1.74 +#endif   /* #ifndef SQLITE_OMIT_BUILTIN_TEST */