ic-sqlite-vfs 0.1.1

SQLite VFS backed directly by Internet Computer stable memory
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

//! SQLite OS initialization hook.
//!
//! `SQLITE_OS_OTHER=1` makes SQLite call these symbols instead of compiling a
//! Unix, Windows, or WASI backend. Registration is idempotent from SQLite's side.

use crate::sqlite_vfs::ffi;
use crate::sqlite_vfs::vfs;
use std::ffi::c_int;
#[cfg(not(target_arch = "wasm32"))]
use std::ptr::NonNull;

pub fn register() -> c_int {
    unsafe { sqlite3_os_init() }
}

#[no_mangle]
/// # Safety
///
/// SQLite calls this during OS initialization. It registers a process-global VFS
/// pointer whose fields are initialized once before registration.
pub unsafe extern "C" fn sqlite3_os_init() -> c_int {
    let vfs = vfs::prepare();
    ffi::sqlite3_vfs_register(vfs, 1)
}

#[no_mangle]
/// # Safety
///
/// SQLite calls this during OS shutdown. The VFS owns no shutdown-time resource.
pub unsafe extern "C" fn sqlite3_os_end() -> c_int {
    ffi::SQLITE_OK
}

#[no_mangle]
#[cfg(not(target_arch = "wasm32"))]
pub extern "C" fn sqlite3_mutex_alloc(_kind: c_int) -> *mut ffi::sqlite3_mutex {
    NonNull::<u8>::dangling()
        .as_ptr()
        .cast::<ffi::sqlite3_mutex>()
}

#[no_mangle]
#[cfg(not(target_arch = "wasm32"))]
pub extern "C" fn sqlite3_mutex_free(_mutex: *mut ffi::sqlite3_mutex) {}

#[no_mangle]
#[cfg(not(target_arch = "wasm32"))]
pub extern "C" fn sqlite3_mutex_enter(_mutex: *mut ffi::sqlite3_mutex) {}

#[no_mangle]
#[cfg(not(target_arch = "wasm32"))]
pub extern "C" fn sqlite3_mutex_try(_mutex: *mut ffi::sqlite3_mutex) -> c_int {
    ffi::SQLITE_OK
}

#[no_mangle]
#[cfg(not(target_arch = "wasm32"))]
pub extern "C" fn sqlite3_mutex_leave(_mutex: *mut ffi::sqlite3_mutex) {}

#[no_mangle]
#[cfg(not(target_arch = "wasm32"))]
pub extern "C" fn sqlite3_mutex_held(_mutex: *mut ffi::sqlite3_mutex) -> c_int {
    1
}

#[no_mangle]
#[cfg(not(target_arch = "wasm32"))]
pub extern "C" fn sqlite3_mutex_notheld(_mutex: *mut ffi::sqlite3_mutex) -> c_int {
    1
}

#[no_mangle]
#[cfg(not(target_arch = "wasm32"))]
pub extern "C" fn sqlite3_db_mutex(_db: *mut ffi::sqlite3) -> *mut ffi::sqlite3_mutex {
    NonNull::<u8>::dangling()
        .as_ptr()
        .cast::<ffi::sqlite3_mutex>()
}