*** DRAFT ***

SQLite Requirement Matrix Details
file_control.html

Index Summary Markup Original


R-61915-31690-21946-53304-13926-27111-60628-08373 tcl slt th3 src

The sqlite3_file_control() interface makes a direct call to the xFileControl method for the sqlite3_io_methods object associated with a particular database identified by the second argument.

/* IMP: R-61915-31690 */
# EVIDENCE-OF: R-61915-31690 The sqlite3_file_control() interface makes
# a direct call to the xFileControl method for the sqlite3_io_methods
# object associated with a particular database identified by the second
# argument.

R-27108-11003-35381-33223-00139-25935-11742-39438 tcl slt th3 src

The name of the database is "main" for the main database or "temp" for the TEMP database, or the name that appears after the AS keyword for databases that are added using the ATTACH SQL command.

/* IMP: R-27108-11003 */
# EVIDENCE-OF: R-27108-11003 The name of the database is "main" for the
# main database or "temp" for the TEMP database, or the name that
# appears after the AS keyword for databases that are added using the
# ATTACH SQL command.

R-09543-06473-23021-32220-32793-21583-15245-47596 tcl slt th3 src

A NULL pointer can be used in place of "main" to refer to the main database file.

/* IMP: R-09543-06473 */
# EVIDENCE-OF: R-09543-06473 A NULL pointer can be used in place of
# "main" to refer to the main database file.

R-11975-28707-46522-06276-23691-04065-63160-37521 tcl slt th3 src

The third and fourth parameters to this routine are passed directly through to the second and third parameters of the xFileControl method.

/* IMP: R-11975-28707 */
# EVIDENCE-OF: R-11975-28707 The third and fourth parameters to this
# routine are passed directly through to the second and third parameters
# of the xFileControl method.

R-65428-21389-17979-34707-50338-54767-57809-35123 tcl slt th3 src

The return value of the xFileControl method becomes the return value of this routine.

/* IMP: R-65428-21389 */
# EVIDENCE-OF: R-65428-21389 The return value of the xFileControl method
# becomes the return value of this routine.

R-14184-13732-63564-17158-02009-26231-20937-39061 tcl slt th3 src

The SQLITE_FCNTL_FILE_POINTER value for the op parameter causes a pointer to the underlying sqlite3_file object to be written into the space pointed to by the 4th parameter.

/* IMP: R-14184-13732 */
# EVIDENCE-OF: R-14184-13732 The SQLITE_FCNTL_FILE_POINTER value for the
# op parameter causes a pointer to the underlying sqlite3_file object to
# be written into the space pointed to by the 4th parameter.

R-14396-37867-24413-20088-54172-40989-25899-41989 tcl slt th3 src

The SQLITE_FCNTL_FILE_POINTER case is a short-circuit path which does not actually invoke the underlying sqlite3_io_methods.

/* IMP: R-14396-37867 */
# EVIDENCE-OF: R-14396-37867 The SQLITE_FCNTL_FILE_POINTER case is a
# short-circuit path which does not actually invoke the underlying
# sqlite3_io_methods.

R-32266-59420-04967-20715-46228-25200-01200-16446 tcl slt th3 src

If the second parameter (zDbName) does not match the name of any open database file, then SQLITE_ERROR is returned.

/* IMP: R-32266-59420 */
# EVIDENCE-OF: R-32266-59420 If the second parameter (zDbName) does not
# match the name of any open database file, then SQLITE_ERROR is
# returned.

R-45221-02523-04020-35318-02486-22619-25012-28682 tcl slt th3 src

This error code is not remembered and will not be recalled by sqlite3_errcode() or sqlite3_errmsg().

/* IMP: R-45221-02523 */
# EVIDENCE-OF: R-45221-02523 This error code is not remembered and will
# not be recalled by sqlite3_errcode() or sqlite3_errmsg().