*** DRAFT ***

SQLite Requirement Matrix Details
c_dbstatus_options.html

Index Summary Markup Original


R-43412-05248-04352-15247-64896-14746-56138-24199 tcl slt th3 src

SQLITE_DBSTATUS_LOOKASIDE_USED This parameter returns the number of lookaside memory slots currently checked out.

th3/req1/dbstatus01.test:48

/* IMP: R-43412-05248 */
# EVIDENCE-OF: R-43412-05248 SQLITE_DBSTATUS_LOOKASIDE_USED This
# parameter returns the number of lookaside memory slots currently
# checked out.

R-23388-15416-08272-50703-43179-31884-02828-12043 tcl slt th3 src

SQLITE_DBSTATUS_LOOKASIDE_HIT This parameter returns the number of malloc attempts that were satisfied using lookaside memory. Only the high-water value is meaningful; the current value is always zero.

/* IMP: R-23388-15416 */
# EVIDENCE-OF: R-23388-15416 SQLITE_DBSTATUS_LOOKASIDE_HIT This
# parameter returns the number of malloc attempts that were satisfied
# using lookaside memory. Only the high-water value is meaningful; the
# current value is always zero.

R-54043-63736-37256-25763-10275-07807-60527-63818 tcl slt th3 src

SQLITE_DBSTATUS_LOOKASIDE_MISS_SIZE This parameter returns the number malloc attempts that might have been satisfied using lookaside memory but failed due to the amount of memory requested being larger than the lookaside slot size. Only the high-water value is meaningful; the current value is always zero.

/* IMP: R-54043-63736 */
# EVIDENCE-OF: R-54043-63736 SQLITE_DBSTATUS_LOOKASIDE_MISS_SIZE This
# parameter returns the number malloc attempts that might have been
# satisfied using lookaside memory but failed due to the amount of
# memory requested being larger than the lookaside slot size. Only the
# high-water value is meaningful; the current value is always zero.

R-52940-53106-43126-08219-27163-02651-42624-21494 tcl slt th3 src

SQLITE_DBSTATUS_LOOKASIDE_MISS_FULL This parameter returns the number malloc attempts that might have been satisfied using lookaside memory but failed due to all lookaside memory already being in use. Only the high-water value is meaningful; the current value is always zero.

/* IMP: R-52940-53106 */
# EVIDENCE-OF: R-52940-53106 SQLITE_DBSTATUS_LOOKASIDE_MISS_FULL This
# parameter returns the number malloc attempts that might have been
# satisfied using lookaside memory but failed due to all lookaside
# memory already being in use. Only the high-water value is meaningful;
# the current value is always zero.

R-58714-09943-11922-47128-02386-08518-39517-24120 tcl slt th3 src

SQLITE_DBSTATUS_CACHE_USED This parameter returns the approximate number of bytes of heap memory used by all pager caches associated with the database connection.

th3/req1/dbstatus01.test:83

/* IMP: R-58714-09943 */
# EVIDENCE-OF: R-58714-09943 SQLITE_DBSTATUS_CACHE_USED This parameter
# returns the approximate number of bytes of heap memory used by all
# pager caches associated with the database connection.

R-26030-41411-57646-19570-38371-36124-26436-49384 tcl slt th3 src

The highwater mark associated with SQLITE_DBSTATUS_CACHE_USED is always 0.

th3/req1/dbstatus01.test:100

/* IMP: R-26030-41411 */
# EVIDENCE-OF: R-26030-41411 The highwater mark associated with
# SQLITE_DBSTATUS_CACHE_USED is always 0.

R-03668-38040-63384-47924-51655-15922-38013-57392 tcl slt th3 src

SQLITE_DBSTATUS_CACHE_USED_SHARED This parameter is similar to DBSTATUS_CACHE_USED, except that if a pager cache is shared between two or more connections the bytes of heap memory used by that pager cache is divided evenly between the attached connections.

/* IMP: R-03668-38040 */
# EVIDENCE-OF: R-03668-38040 SQLITE_DBSTATUS_CACHE_USED_SHARED This
# parameter is similar to DBSTATUS_CACHE_USED, except that if a pager
# cache is shared between two or more connections the bytes of heap
# memory used by that pager cache is divided evenly between the attached
# connections.

R-10596-27541-11253-59899-09809-63621-63871-56727 tcl slt th3 src

The highwater mark associated with SQLITE_DBSTATUS_CACHE_USED_SHARED is always 0.

/* IMP: R-10596-27541 */
# EVIDENCE-OF: R-10596-27541 The highwater mark associated with
# SQLITE_DBSTATUS_CACHE_USED_SHARED is always 0.

R-53010-63100-48596-37758-55156-50818-27273-22273 tcl slt th3 src

SQLITE_DBSTATUS_SCHEMA_USED This parameter returns the approximate number of bytes of heap memory used to store the schema for all databases associated with the connection - main, temp, and any ATTACH-ed databases.

th3/req1/dbstatus02.test:9

/* IMP: R-53010-63100 */
# EVIDENCE-OF: R-53010-63100 SQLITE_DBSTATUS_SCHEMA_USED This parameter
# returns the approximate number of bytes of heap memory used to store
# the schema for all databases associated with the connection - main,
# temp, and any ATTACH-ed databases.

R-12786-00766-63482-41386-10445-23868-47532-37384 tcl slt th3 src

The full amount of memory used by the schemas is reported, even if the schema memory is shared with other database connections due to shared cache mode being enabled.

th3/req1/dbstatus02.test:47

/* IMP: R-12786-00766 */
# EVIDENCE-OF: R-12786-00766 The full amount of memory used by the
# schemas is reported, even if the schema memory is shared with other
# database connections due to shared cache mode being enabled.

R-52885-58365-34589-60224-33569-54251-15646-22637 tcl slt th3 src

The highwater mark associated with SQLITE_DBSTATUS_SCHEMA_USED is always 0.

th3/req1/dbstatus01.test:106   th3/req1/dbstatus02.test:31

/* IMP: R-52885-58365 */
# EVIDENCE-OF: R-52885-58365 The highwater mark associated with
# SQLITE_DBSTATUS_SCHEMA_USED is always 0.

R-42475-05522-33974-48486-41062-27037-25414-59266 tcl slt th3 src

SQLITE_DBSTATUS_STMT_USED This parameter returns the approximate number of bytes of heap and lookaside memory used by all prepared statements associated with the database connection.

th3/req1/dbstatus01.test:114

/* IMP: R-42475-05522 */
# EVIDENCE-OF: R-42475-05522 SQLITE_DBSTATUS_STMT_USED This parameter
# returns the approximate number of bytes of heap and lookaside memory
# used by all prepared statements associated with the database
# connection.

R-64479-57858-30969-38404-45379-17984-36095-58502 tcl slt th3 src

The highwater mark associated with SQLITE_DBSTATUS_STMT_USED is always 0.

src/status.c:347   th3/req1/dbstatus01.test:119

/* IMP: R-64479-57858 */
# EVIDENCE-OF: R-64479-57858 The highwater mark associated with
# SQLITE_DBSTATUS_STMT_USED is always 0.

R-64365-33714-02196-49679-58449-42596-39965-50249 tcl slt th3 src

SQLITE_DBSTATUS_CACHE_HIT This parameter returns the number of pager cache hits that have occurred.

/* IMP: R-64365-33714 */
# EVIDENCE-OF: R-64365-33714 SQLITE_DBSTATUS_CACHE_HIT This parameter
# returns the number of pager cache hits that have occurred.

R-42420-56072-06217-40848-64970-52103-43558-36371 tcl slt th3 src

The highwater mark associated with SQLITE_DBSTATUS_CACHE_HIT is always 0.

src/status.c:375

/* IMP: R-42420-56072 */
# EVIDENCE-OF: R-42420-56072 The highwater mark associated with
# SQLITE_DBSTATUS_CACHE_HIT is always 0.

R-40463-24712-34752-07038-54630-26227-29776-31431 tcl slt th3 src

SQLITE_DBSTATUS_CACHE_MISS This parameter returns the number of pager cache misses that have occurred.

/* IMP: R-40463-24712 */
# EVIDENCE-OF: R-40463-24712 SQLITE_DBSTATUS_CACHE_MISS This parameter
# returns the number of pager cache misses that have occurred.

R-54100-20147-64333-16407-13054-37480-42962-25139 tcl slt th3 src

The highwater mark associated with SQLITE_DBSTATUS_CACHE_MISS is always 0.

src/status.c:376

/* IMP: R-54100-20147 */
# EVIDENCE-OF: R-54100-20147 The highwater mark associated with
# SQLITE_DBSTATUS_CACHE_MISS is always 0.

R-52494-36749-63981-51564-54926-02873-46485-09219 tcl slt th3 src

SQLITE_DBSTATUS_CACHE_WRITE This parameter returns the number of dirty cache entries that have been written to disk. Specifically, the number of pages written to the wal file in wal mode databases, or the number of pages written to the database file in rollback mode databases. Any pages written as part of transaction rollback or database recovery operations are not included. If an IO or other error occurs while writing a page to disk, the effect on subsequent SQLITE_DBSTATUS_CACHE_WRITE requests is undefined.

/* IMP: R-52494-36749 */
# EVIDENCE-OF: R-52494-36749 SQLITE_DBSTATUS_CACHE_WRITE This parameter
# returns the number of dirty cache entries that have been written to
# disk. Specifically, the number of pages written to the wal file in wal
# mode databases, or the number of pages written to the database file in
# rollback mode databases. Any pages written as part of transaction
# rollback or database recovery operations are not included. If an IO or
# other error occurs while writing a page to disk, the effect on
# subsequent SQLITE_DBSTATUS_CACHE_WRITE requests is undefined.

R-29431-39229-16691-57532-51214-42870-42294-30038 tcl slt th3 src

The highwater mark associated with SQLITE_DBSTATUS_CACHE_WRITE is always 0.

src/status.c:377

/* IMP: R-29431-39229 */
# EVIDENCE-OF: R-29431-39229 The highwater mark associated with
# SQLITE_DBSTATUS_CACHE_WRITE is always 0.

R-43689-60751-17173-17363-04961-34787-47888-07177 tcl slt th3 src

SQLITE_DBSTATUS_CACHE_SPILL This parameter returns the number of dirty cache entries that have been written to disk in the middle of a transaction due to the page cache overflowing. Transactions are more efficient if they are written to disk all at once. When pages spill mid-transaction, that introduces additional overhead. This parameter can be used help identify inefficiencies that can be resolved by increasing the cache size.

^(SQLITE_DBSTATUS_DEFERRED_FKS This parameter returns zero for the current value if and only if all foreign key constraints (deferred or immediate) have been resolved.

/* IMP: R-43689-60751 */
# EVIDENCE-OF: R-43689-60751 SQLITE_DBSTATUS_CACHE_SPILL This parameter
# returns the number of dirty cache entries that have been written to
# disk in the middle of a transaction due to the page cache overflowing.
# Transactions are more efficient if they are written to disk all at
# once. When pages spill mid-transaction, that introduces additional
# overhead. This parameter can be used help identify inefficiencies that
# can be resolved by increasing the cache size.
# ^(SQLITE_DBSTATUS_DEFERRED_FKS This parameter returns zero for the
# current value if and only if all foreign key constraints (deferred or
# immediate) have been resolved.

R-11967-56545-48759-50416-31335-06796-11719-37759 tcl slt th3 src

The highwater mark is always 0.

src/status.c:387

/* IMP: R-11967-56545 */
# EVIDENCE-OF: R-11967-56545 The highwater mark is always 0.