|
sl@0
|
1 |
/*
|
|
sl@0
|
2 |
** 2008 Jan 22
|
|
sl@0
|
3 |
**
|
|
sl@0
|
4 |
** The author disclaims copyright to this source code. In place of
|
|
sl@0
|
5 |
** a legal notice, here is a blessing:
|
|
sl@0
|
6 |
**
|
|
sl@0
|
7 |
** May you do good and not evil.
|
|
sl@0
|
8 |
** May you find forgiveness for yourself and forgive others.
|
|
sl@0
|
9 |
** May you share freely, never taking more than you give.
|
|
sl@0
|
10 |
**
|
|
sl@0
|
11 |
*************************************************************************
|
|
sl@0
|
12 |
**
|
|
sl@0
|
13 |
** $Id: fault.c,v 1.11 2008/09/02 00:52:52 drh Exp $
|
|
sl@0
|
14 |
*/
|
|
sl@0
|
15 |
|
|
sl@0
|
16 |
/*
|
|
sl@0
|
17 |
** This file contains code to support the concept of "benign"
|
|
sl@0
|
18 |
** malloc failures (when the xMalloc() or xRealloc() method of the
|
|
sl@0
|
19 |
** sqlite3_mem_methods structure fails to allocate a block of memory
|
|
sl@0
|
20 |
** and returns 0).
|
|
sl@0
|
21 |
**
|
|
sl@0
|
22 |
** Most malloc failures are non-benign. After they occur, SQLite
|
|
sl@0
|
23 |
** abandons the current operation and returns an error code (usually
|
|
sl@0
|
24 |
** SQLITE_NOMEM) to the user. However, sometimes a fault is not necessarily
|
|
sl@0
|
25 |
** fatal. For example, if a malloc fails while resizing a hash table, this
|
|
sl@0
|
26 |
** is completely recoverable simply by not carrying out the resize. The
|
|
sl@0
|
27 |
** hash table will continue to function normally. So a malloc failure
|
|
sl@0
|
28 |
** during a hash table resize is a benign fault.
|
|
sl@0
|
29 |
*/
|
|
sl@0
|
30 |
|
|
sl@0
|
31 |
#include "sqliteInt.h"
|
|
sl@0
|
32 |
|
|
sl@0
|
33 |
#ifndef SQLITE_OMIT_BUILTIN_TEST
|
|
sl@0
|
34 |
|
|
sl@0
|
35 |
/*
|
|
sl@0
|
36 |
** Global variables.
|
|
sl@0
|
37 |
*/
|
|
sl@0
|
38 |
typedef struct BenignMallocHooks BenignMallocHooks;
|
|
sl@0
|
39 |
static SQLITE_WSD struct BenignMallocHooks {
|
|
sl@0
|
40 |
void (*xBenignBegin)(void);
|
|
sl@0
|
41 |
void (*xBenignEnd)(void);
|
|
sl@0
|
42 |
} sqlite3Hooks = { 0, 0 };
|
|
sl@0
|
43 |
|
|
sl@0
|
44 |
/* The "wsdHooks" macro will resolve to the appropriate BenignMallocHooks
|
|
sl@0
|
45 |
** structure. If writable static data is unsupported on the target,
|
|
sl@0
|
46 |
** we have to locate the state vector at run-time. In the more common
|
|
sl@0
|
47 |
** case where writable static data is supported, wsdHooks can refer directly
|
|
sl@0
|
48 |
** to the "sqlite3Hooks" state vector declared above.
|
|
sl@0
|
49 |
*/
|
|
sl@0
|
50 |
#ifdef SQLITE_OMIT_WSD
|
|
sl@0
|
51 |
# define wsdHooksInit \
|
|
sl@0
|
52 |
BenignMallocHooks *x = &GLOBAL(BenignMallocHooks,sqlite3Hooks)
|
|
sl@0
|
53 |
# define wsdHooks x[0]
|
|
sl@0
|
54 |
#else
|
|
sl@0
|
55 |
# define wsdHooksInit
|
|
sl@0
|
56 |
# define wsdHooks sqlite3Hooks
|
|
sl@0
|
57 |
#endif
|
|
sl@0
|
58 |
|
|
sl@0
|
59 |
|
|
sl@0
|
60 |
/*
|
|
sl@0
|
61 |
** Register hooks to call when sqlite3BeginBenignMalloc() and
|
|
sl@0
|
62 |
** sqlite3EndBenignMalloc() are called, respectively.
|
|
sl@0
|
63 |
*/
|
|
sl@0
|
64 |
void sqlite3BenignMallocHooks(
|
|
sl@0
|
65 |
void (*xBenignBegin)(void),
|
|
sl@0
|
66 |
void (*xBenignEnd)(void)
|
|
sl@0
|
67 |
){
|
|
sl@0
|
68 |
wsdHooksInit;
|
|
sl@0
|
69 |
wsdHooks.xBenignBegin = xBenignBegin;
|
|
sl@0
|
70 |
wsdHooks.xBenignEnd = xBenignEnd;
|
|
sl@0
|
71 |
}
|
|
sl@0
|
72 |
|
|
sl@0
|
73 |
/*
|
|
sl@0
|
74 |
** This (sqlite3EndBenignMalloc()) is called by SQLite code to indicate that
|
|
sl@0
|
75 |
** subsequent malloc failures are benign. A call to sqlite3EndBenignMalloc()
|
|
sl@0
|
76 |
** indicates that subsequent malloc failures are non-benign.
|
|
sl@0
|
77 |
*/
|
|
sl@0
|
78 |
void sqlite3BeginBenignMalloc(void){
|
|
sl@0
|
79 |
wsdHooksInit;
|
|
sl@0
|
80 |
if( wsdHooks.xBenignBegin ){
|
|
sl@0
|
81 |
wsdHooks.xBenignBegin();
|
|
sl@0
|
82 |
}
|
|
sl@0
|
83 |
}
|
|
sl@0
|
84 |
void sqlite3EndBenignMalloc(void){
|
|
sl@0
|
85 |
wsdHooksInit;
|
|
sl@0
|
86 |
if( wsdHooks.xBenignEnd ){
|
|
sl@0
|
87 |
wsdHooks.xBenignEnd();
|
|
sl@0
|
88 |
}
|
|
sl@0
|
89 |
}
|
|
sl@0
|
90 |
|
|
sl@0
|
91 |
#endif /* #ifndef SQLITE_OMIT_BUILTIN_TEST */
|