xref: /netbsd-src/external/public-domain/sqlite/man/sqlite3_release_memory.3 (revision 627f7eb200a4419d89b531d55fccd2ee3ffdcde0)
1.Dd December 19, 2018
2.Dt SQLITE3_RELEASE_MEMORY 3
3.Os
4.Sh NAME
5.Nm sqlite3_release_memory
6.Nd Attempt To Free Heap Memory
7.Sh SYNOPSIS
8.Ft int
9.Fo sqlite3_release_memory
10.Fa "int"
11.Fc
12.Sh DESCRIPTION
13The sqlite3_release_memory() interface attempts to free N bytes of
14heap memory by deallocating non-essential memory allocations held by
15the database library.
16Memory used to cache database pages to improve performance is an example
17of non-essential memory.
18sqlite3_release_memory() returns the number of bytes actually freed,
19which might be more or less than the amount requested.
20The sqlite3_release_memory() routine is a no-op returning zero if SQLite
21is not compiled with SQLITE_ENABLE_MEMORY_MANAGEMENT.
22.Pp
23.Sh SEE ALSO
24.Xr sqlite3_db_release_memory 3
25