drh | 960e8c6 | 2001-04-03 16:53:21 +0000 | [diff] [blame] | 1 | /* |
drh | b19a2bc | 2001-09-16 00:13:26 +0000 | [diff] [blame^] | 2 | ** 2001 September 15 |
drh | 960e8c6 | 2001-04-03 16:53:21 +0000 | [diff] [blame] | 3 | ** |
drh | b19a2bc | 2001-09-16 00:13:26 +0000 | [diff] [blame^] | 4 | ** The author disclaims copyright to this source code. In place of |
| 5 | ** a legal notice, here is a blessing: |
drh | 960e8c6 | 2001-04-03 16:53:21 +0000 | [diff] [blame] | 6 | ** |
drh | b19a2bc | 2001-09-16 00:13:26 +0000 | [diff] [blame^] | 7 | ** May you do good and not evil. |
| 8 | ** May you find forgiveness for yourself and forgive others. |
| 9 | ** May you share freely, never taking more than you give. |
drh | 960e8c6 | 2001-04-03 16:53:21 +0000 | [diff] [blame] | 10 | ** |
| 11 | ************************************************************************* |
| 12 | ** This header file defines the interface that the sqlite page cache |
| 13 | ** subsystem. The page cache subsystem reads and writes a file a page |
| 14 | ** at a time and provides a journal for rollback. |
| 15 | ** |
drh | b19a2bc | 2001-09-16 00:13:26 +0000 | [diff] [blame^] | 16 | ** @(#) $Id: pager.h,v 1.11 2001/09/16 00:13:27 drh Exp $ |
drh | 960e8c6 | 2001-04-03 16:53:21 +0000 | [diff] [blame] | 17 | */ |
drh | 960e8c6 | 2001-04-03 16:53:21 +0000 | [diff] [blame] | 18 | |
| 19 | /* |
| 20 | ** The size of one page |
| 21 | */ |
| 22 | #define SQLITE_PAGE_SIZE 1024 |
| 23 | |
| 24 | /* |
drh | 092d035 | 2001-09-15 13:15:12 +0000 | [diff] [blame] | 25 | ** Maximum number of pages in one database. (This is a limitation of |
| 26 | ** imposed by 4GB files size limits.) |
| 27 | */ |
| 28 | #define SQLITE_MAX_PAGE 1073741823 |
| 29 | |
| 30 | /* |
drh | 960e8c6 | 2001-04-03 16:53:21 +0000 | [diff] [blame] | 31 | ** The type used to represent a page number. The first page in a file |
| 32 | ** is called page 1. 0 is used to represent "not a page". |
| 33 | */ |
| 34 | typedef unsigned int Pgno; |
| 35 | |
| 36 | /* |
| 37 | ** Each open file is managed by a separate instance of the "Pager" structure. |
| 38 | */ |
| 39 | typedef struct Pager Pager; |
| 40 | |
drh | 72f8286 | 2001-05-24 21:06:34 +0000 | [diff] [blame] | 41 | int sqlitepager_open(Pager **ppPager,const char *zFilename,int nPage,int nEx); |
drh | 8c42ca9 | 2001-06-22 19:15:00 +0000 | [diff] [blame] | 42 | void sqlitepager_set_destructor(Pager*, void(*)(void*)); |
drh | f57b14a | 2001-09-14 18:54:08 +0000 | [diff] [blame] | 43 | void sqlitepager_set_cachesize(Pager*, int); |
drh | d9b0257 | 2001-04-15 00:37:09 +0000 | [diff] [blame] | 44 | int sqlitepager_close(Pager *pPager); |
| 45 | int sqlitepager_get(Pager *pPager, Pgno pgno, void **ppPage); |
drh | 7e3b0a0 | 2001-04-28 16:52:40 +0000 | [diff] [blame] | 46 | void *sqlitepager_lookup(Pager *pPager, Pgno pgno); |
drh | 8c42ca9 | 2001-06-22 19:15:00 +0000 | [diff] [blame] | 47 | int sqlitepager_ref(void*); |
drh | d9b0257 | 2001-04-15 00:37:09 +0000 | [diff] [blame] | 48 | int sqlitepager_unref(void*); |
| 49 | Pgno sqlitepager_pagenumber(void*); |
| 50 | int sqlitepager_write(void*); |
drh | 6019e16 | 2001-07-02 17:51:45 +0000 | [diff] [blame] | 51 | int sqlitepager_iswriteable(void*); |
drh | d9b0257 | 2001-04-15 00:37:09 +0000 | [diff] [blame] | 52 | int sqlitepager_pagecount(Pager*); |
| 53 | int sqlitepager_commit(Pager*); |
| 54 | int sqlitepager_rollback(Pager*); |
drh | 5e00f6c | 2001-09-13 13:46:56 +0000 | [diff] [blame] | 55 | int sqlitepager_isreadonly(Pager*); |
drh | d9b0257 | 2001-04-15 00:37:09 +0000 | [diff] [blame] | 56 | int *sqlitepager_stats(Pager*); |
drh | dd79342 | 2001-06-28 01:54:48 +0000 | [diff] [blame] | 57 | |
| 58 | #ifdef SQLITE_TEST |
| 59 | void sqlitepager_refdump(Pager*); |
| 60 | int pager_refinfo_enable; |
| 61 | #endif |