xref: /netbsd-src/external/public-domain/sqlite/man/sqlite3_test_control.3 (revision 82d56013d7b633d116a93943de88e08335357a7c)
1.Dd December 19, 2018
2.Dt SQLITE3_TEST_CONTROL 3
3.Os
4.Sh NAME
5.Nm sqlite3_test_control
6.Nd Testing Interface
7.Sh SYNOPSIS
8.Ft int
9.Fo sqlite3_test_control
10.Fa "int op"
11.Fa "..."
12.Fc
13.Sh DESCRIPTION
14The sqlite3_test_control() interface is used to read out internal state
15of SQLite and to inject faults into SQLite for testing purposes.
16The first parameter is an operation code that determines the number,
17meaning, and operation of all subsequent parameters.
18.Pp
19This interface is not for use by applications.
20It exists solely for verifying the correct operation of the SQLite
21library.
22Depending on how the SQLite library is compiled, this interface might
23not exist.
24.Pp
25The details of the operation codes, their meanings, the parameters
26they take, and what they do are all subject to change without notice.
27Unlike most of the SQLite API, this function is not guaranteed to operate
28consistently from one release to the next.
29