*** DRAFT ***

SQLite Requirement Matrix Details
soft_heap_limit64.html

Index Summary Markup Original


R-54493-30181-37798-05514-46235-61023-30019-39106 tcl slt th3 src

The sqlite3_soft_heap_limit64() interface sets and/or queries the soft limit on the amount of heap memory that may be allocated by SQLite.

th3/req1/softheaplimit01.test:12

/* IMP: R-54493-30181 */
# EVIDENCE-OF: R-54493-30181 The sqlite3_soft_heap_limit64() interface
# sets and/or queries the soft limit on the amount of heap memory that
# may be allocated by SQLite.

R-27925-06263-58551-32265-51230-19990-38380-59040 tcl slt th3 src

SQLite strives to keep heap memory utilization below the soft heap limit by reducing the number of pages held in the page cache as heap memory usages approaches the limit.

th3/req1/softheaplimit02.test:9

/* IMP: R-27925-06263 */
# EVIDENCE-OF: R-27925-06263 SQLite strives to keep heap memory
# utilization below the soft heap limit by reducing the number of pages
# held in the page cache as heap memory usages approaches the limit.

R-54035-60779-28299-56700-44695-40391-47008-32723 tcl slt th3 src

The soft heap limit is "soft" because even though SQLite strives to stay below the limit, it will exceed the limit rather than generate an SQLITE_NOMEM error.

th3/req1/softheaplimit02.test:16

/* IMP: R-54035-60779 */
# EVIDENCE-OF: R-54035-60779 The soft heap limit is "soft" because even
# though SQLite strives to stay below the limit, it will exceed the
# limit rather than generate an SQLITE_NOMEM error.

R-47776-28526-56266-60263-62785-55085-28678-57655 tcl slt th3 src

The return value from sqlite3_soft_heap_limit64() is the size of the soft heap limit prior to the call, or negative in the case of an error.

th3/req1/softheaplimit01.test:16

/* IMP: R-47776-28526 */
# EVIDENCE-OF: R-47776-28526 The return value from
# sqlite3_soft_heap_limit64() is the size of the soft heap limit prior
# to the call, or negative in the case of an error.

R-59203-27417-45824-06812-16241-47628-05439-60390 tcl slt th3 src

If the argument N is negative then no change is made to the soft heap limit.

th3/req1/softheaplimit01.test:20

/* IMP: R-59203-27417 */
# EVIDENCE-OF: R-59203-27417 If the argument N is negative then no
# change is made to the soft heap limit.

R-06665-27325-40160-13157-49305-60075-62484-50967 tcl slt th3 src

If the argument N is zero then the soft heap limit is disabled.

th3/req1/softheaplimit02.test:23

/* IMP: R-06665-27325 */
# EVIDENCE-OF: R-06665-27325 If the argument N is zero then the soft
# heap limit is disabled.

R-61080-17963-44773-61437-15478-48991-05148-21886 tcl slt th3 src

The soft heap limit is not enforced in the current implementation if one or more of following conditions are true:

th3/req1/softheaplimit02.test:29

/* IMP: R-61080-17963 */
# EVIDENCE-OF: R-61080-17963 The soft heap limit is not enforced in the
# current implementation if one or more of following conditions are
# true: The soft heap limit is set to zero. Memory accounting is
# disabled using a combination of the
# sqlite3_config(SQLITE_CONFIG_MEMSTATUS,...) start-time option and the
# SQLITE_DEFAULT_MEMSTATUS compile-time option. An alternative page
# cache implementation is specified using
# sqlite3_config(SQLITE_CONFIG_PCACHE2,...). The page cache allocates
# from its own memory pool supplied by
# sqlite3_config(SQLITE_CONFIG_PAGECACHE,...) rather than from the heap.