|
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.10 2008/06/22 12:37:58 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 |
static struct BenignMallocHooks {
|
|
sl@0
|
39 |
void (*xBenignBegin)(void);
|
|
sl@0
|
40 |
void (*xBenignEnd)(void);
|
|
sl@0
|
41 |
} hooks;
|
|
sl@0
|
42 |
|
|
sl@0
|
43 |
/*
|
|
sl@0
|
44 |
** Register hooks to call when sqlite3BeginBenignMalloc() and
|
|
sl@0
|
45 |
** sqlite3EndBenignMalloc() are called, respectively.
|
|
sl@0
|
46 |
*/
|
|
sl@0
|
47 |
void sqlite3BenignMallocHooks(
|
|
sl@0
|
48 |
void (*xBenignBegin)(void),
|
|
sl@0
|
49 |
void (*xBenignEnd)(void)
|
|
sl@0
|
50 |
){
|
|
sl@0
|
51 |
hooks.xBenignBegin = xBenignBegin;
|
|
sl@0
|
52 |
hooks.xBenignEnd = xBenignEnd;
|
|
sl@0
|
53 |
}
|
|
sl@0
|
54 |
|
|
sl@0
|
55 |
/*
|
|
sl@0
|
56 |
** This (sqlite3EndBenignMalloc()) is called by SQLite code to indicate that
|
|
sl@0
|
57 |
** subsequent malloc failures are benign. A call to sqlite3EndBenignMalloc()
|
|
sl@0
|
58 |
** indicates that subsequent malloc failures are non-benign.
|
|
sl@0
|
59 |
*/
|
|
sl@0
|
60 |
void sqlite3BeginBenignMalloc(void){
|
|
sl@0
|
61 |
if( hooks.xBenignBegin ){
|
|
sl@0
|
62 |
hooks.xBenignBegin();
|
|
sl@0
|
63 |
}
|
|
sl@0
|
64 |
}
|
|
sl@0
|
65 |
void sqlite3EndBenignMalloc(void){
|
|
sl@0
|
66 |
if( hooks.xBenignEnd ){
|
|
sl@0
|
67 |
hooks.xBenignEnd();
|
|
sl@0
|
68 |
}
|
|
sl@0
|
69 |
}
|
|
sl@0
|
70 |
|
|
sl@0
|
71 |
#endif /* #ifndef SQLITE_OMIT_BUILTIN_TEST */
|