OLD | NEW |
| (Empty) |
1 /* | |
2 ** 2011 March 18 | |
3 ** | |
4 ** The author disclaims copyright to this source code. In place of | |
5 ** a legal notice, here is a blessing: | |
6 ** | |
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. | |
10 ** | |
11 ************************************************************************* | |
12 ** | |
13 ** This file contains a VFS "shim" - a layer that sits in between the | |
14 ** pager and the real VFS. | |
15 ** | |
16 ** This particular shim enforces a multiplex system on DB files. | |
17 ** This shim shards/partitions a single DB file into smaller | |
18 ** "chunks" such that the total DB file size may exceed the maximum | |
19 ** file size of the underlying file system. | |
20 ** | |
21 */ | |
22 | |
23 #ifndef _TEST_MULTIPLEX_H | |
24 #define _TEST_MULTIPLEX_H | |
25 | |
26 /* | |
27 ** CAPI: File-control Operations Supported by Multiplex VFS | |
28 ** | |
29 ** Values interpreted by the xFileControl method of a Multiplex VFS db file-hand
le. | |
30 ** | |
31 ** MULTIPLEX_CTRL_ENABLE: | |
32 ** This file control is used to enable or disable the multiplex | |
33 ** shim. | |
34 ** | |
35 ** MULTIPLEX_CTRL_SET_CHUNK_SIZE: | |
36 ** This file control is used to set the maximum allowed chunk | |
37 ** size for a multiplex file set. The chunk size should be | |
38 ** a multiple of SQLITE_MAX_PAGE_SIZE, and will be rounded up | |
39 ** if not. | |
40 ** | |
41 ** MULTIPLEX_CTRL_SET_MAX_CHUNKS: | |
42 ** This file control is used to set the maximum number of chunks | |
43 ** allowed to be used for a mutliplex file set. | |
44 */ | |
45 #define MULTIPLEX_CTRL_ENABLE 214014 | |
46 #define MULTIPLEX_CTRL_SET_CHUNK_SIZE 214015 | |
47 #define MULTIPLEX_CTRL_SET_MAX_CHUNKS 214016 | |
48 | |
49 #ifdef __cplusplus | |
50 extern "C" { | |
51 #endif | |
52 | |
53 /* | |
54 ** CAPI: Initialize the multiplex VFS shim - sqlite3_multiplex_initialize() | |
55 ** | |
56 ** Use the VFS named zOrigVfsName as the VFS that does the actual work. | |
57 ** Use the default if zOrigVfsName==NULL. | |
58 ** | |
59 ** The multiplex VFS shim is named "multiplex". It will become the default | |
60 ** VFS if makeDefault is non-zero. | |
61 ** | |
62 ** An auto-extension is registered which will make the function | |
63 ** multiplex_control() available to database connections. This | |
64 ** function gives access to the xFileControl interface of the | |
65 ** multiplex VFS shim. | |
66 ** | |
67 ** SELECT multiplex_control(<op>,<val>); | |
68 ** | |
69 ** <op>=1 MULTIPLEX_CTRL_ENABLE | |
70 ** <val>=0 disable | |
71 ** <val>=1 enable | |
72 ** | |
73 ** <op>=2 MULTIPLEX_CTRL_SET_CHUNK_SIZE | |
74 ** <val> int, chunk size | |
75 ** | |
76 ** <op>=3 MULTIPLEX_CTRL_SET_MAX_CHUNKS | |
77 ** <val> int, max chunks | |
78 ** | |
79 ** THIS ROUTINE IS NOT THREADSAFE. Call this routine exactly once | |
80 ** during start-up. | |
81 */ | |
82 extern int sqlite3_multiplex_initialize(const char *zOrigVfsName, int makeDefaul
t); | |
83 | |
84 /* | |
85 ** CAPI: Shutdown the multiplex system - sqlite3_multiplex_shutdown() | |
86 ** | |
87 ** All SQLite database connections must be closed before calling this | |
88 ** routine. | |
89 ** | |
90 ** THIS ROUTINE IS NOT THREADSAFE. Call this routine exactly once while | |
91 ** shutting down in order to free all remaining multiplex groups. | |
92 */ | |
93 extern int sqlite3_multiplex_shutdown(int eForce); | |
94 | |
95 #ifdef __cplusplus | |
96 } /* End of the 'extern "C"' block */ | |
97 #endif | |
98 | |
99 #endif /* _TEST_MULTIPLEX_H */ | |
OLD | NEW |