Manual Page Result
0
Command: sqlite3_trace_v2 | Section: 3 | Source: NetBSD | File: sqlite3_trace_v2.3
SQLITE3_TRACE_V2(3) FreeBSD Library Functions Manual SQLITE3_TRACE_V2(3)
NAME
sqlite3_trace_v2 - SQL Trace Hook
SYNOPSIS
int
sqlite3_trace_v2(sqlite3*, unsigned uMask,
int(*xCallback)(unsigned,void*,void*,void*), void *pCtx );
DESCRIPTION
The sqlite3_trace_v2(D,M,X,P) interface registers a trace callback
function X against database connection D, using property mask M and
context pointer P. If the X callback is NULL or if the M mask is zero,
then tracing is disabled. The M argument should be the bitwise OR-ed
combination of zero or more SQLITE_TRACE constants.
Each call to either sqlite3_trace() or sqlite3_trace_v2() overrides
(cancels) any prior calls to sqlite3_trace() or sqlite3_trace_v2().
The X callback is invoked whenever any of the events identified by mask M
occur. The integer return value from the callback is currently ignored,
though this may change in future releases. Callback implementations
should return zero to ensure future compatibility.
A trace callback is invoked with four arguments: callback(T,C,P,X). The
T argument is one of the SQLITE_TRACE constants to indicate why the
callback was invoked. The C argument is a copy of the context pointer.
The P and X arguments are pointers whose meanings depend on T.
The sqlite3_trace_v2() interface is intended to replace the legacy
interfaces sqlite3_trace() and sqlite3_profile(), both of which are
deprecated.
SEE ALSO
sqlite3(3), sqlite3_trace(3), SQLITE_TRACE_STMT(3)
FreeBSD 14.1-RELEASE-p8 December 19, 2018 FreeBSD 14.1-RELEASE-p8