.Dd April 29, 2026
.Dt SQLITE3_DB_STATUS 3
.Os
.Sh NAME
.Nm sqlite3_db_status ,
.Nm sqlite3_db_status64
.Nd database connection status
.Sh SYNOPSIS
.In sqlite3.h
.Ft int
.Fo sqlite3_db_status
.Fa "sqlite3*"
.Fa "int op"
.Fa "int *pCur"
.Fa "int *pHiwtr"
.Fa "int resetFlg"
.Fc
.Ft int
.Fo sqlite3_db_status64
.Fa "sqlite3*"
.Fa "int"
.Fa "sqlite3_int64*"
.Fa "sqlite3_int64*"
.Fa "int"
.Fc
.Sh DESCRIPTION
This interface is used to retrieve runtime status information about
a single database connection.
The first argument is the database connection object to be interrogated.
The second argument is an integer constant, taken from the set of SQLITE_DBSTATUS options,
that determines the parameter to interrogate.
The set of SQLITE_DBSTATUS options is likely
to grow in future releases of SQLite.
.Pp
The current value of the requested parameter is written into *pCur
and the highest instantaneous value is written into *pHiwtr.
If the resetFlg is true, then the highest instantaneous value is reset
back down to the current value.
.Pp
The sqlite3_db_status() routine returns SQLITE_OK on success and a
non-zero error code on failure.
.Pp
The sqlite3_db_status64(D,O,C,H,R) routine works exactly the same way
as sqlite3_db_status(D,O,C,H,R) routine except that the C and H parameters
are pointer to 64-bit integers (type: sqlite3_int64) instead of pointers
to 32-bit integers, which allows larger status values to be returned.
If a status value exceeds 2,147,483,647 then sqlite3_db_status() will
truncate the value whereas sqlite3_db_status64() will return the full
value.
.Pp
.Sh IMPLEMENTATION NOTES
These declarations were extracted from the
interface documentation at line 9032.
.Bd -literal
SQLITE_API int sqlite3_db_status(sqlite3*, int op, int *pCur, int *pHiwtr, int resetFlg);
SQLITE_API int sqlite3_db_status64(sqlite3*,int,sqlite3_int64*,sqlite3_int64*,int);
.Ed
.Sh SEE ALSO
.Xr sqlite3 3 ,
.Xr sqlite3_status 3 ,
.Xr sqlite3_stmt_status 3 ,
.Xr SQLITE_DBSTATUS_LOOKASIDE_USED 3