summaryrefslogtreecommitdiffstats
path: root/www/cli.html
diff options
context:
space:
mode:
Diffstat (limited to 'www/cli.html')
-rw-r--r--www/cli.html23
1 files changed, 13 insertions, 10 deletions
diff --git a/www/cli.html b/www/cli.html
index 773c353..e99e497 100644
--- a/www/cli.html
+++ b/www/cli.html
@@ -1945,16 +1945,19 @@ script to run under --safe mode.
</p><h2 id="the_unsafe_testing_command_line_option"><span>23.2. </span>The --unsafe-testing command-line option</h2>
-<p>The --unsafe-testing command-line option supports use of the CLI for
-internal testing of the SQLite library. It is not needed or useful for using
-the CLI as a utility for creating, modifying or querying SQLite databases.
-Its intended use is to permit scripted testing with direct schema changes,
-defensive measures defeated, and certain special-purpose, undocumented,
-test-oriented dot-commands enabled.
+<p>The --unsafe-testing command-line option enables features of the CLI
+that are intended for internal testing only. The --unsafe-testing option
+disables defenses that are built into SQLite. Examples of
+that are disabled defenses include <a href="c3ref/c_dbconfig_defensive.html#sqlitedbconfigdefensive">SQLITE_DBCONFIG_DEFENSIVE</a> and
+<a href="c3ref/c_dbconfig_defensive.html#sqlitedbconfigtrustedschema">SQLITE_DBCONFIG_TRUSTED_SCHEMA</a>.
+The --unsafe-testing option also enables features that, if misused, might
+cause database corruption, memory errors, or
+similar problems in the CLI itself or in the SQLite library.
+Example of features that --unsafe-testing enables include
+the <a href="imposter.html#dotimposter">.imposter dot-command</a> and <a href="c3ref/c_testctrl_always.html">SQLITE_TESTCTRL_ASSERT</a>.
</p><p>
-Misbehavior which requires use of the --unsafe-testing option to be induced
-will generally not be considered a bug for that reason alone. CLI behavior
-with --unsafe-testing is not supported or defined.
+Misbehavior which requires use of the --unsafe-testing option
+will generally not be considered a bug.
</p><h2 id="the_no_utf8_and_utf8_command_line_options"><span>23.3. </span>The --no-utf8 and --utf8 command-line options</h2>
@@ -2046,5 +2049,5 @@ provide a full-featured command-line shell:
</li><li> <a href="compile.html#enable_fts4">-DSQLITE_ENABLE_FTS4</a>
</li><li> <a href="compile.html#enable_fts5">-DSQLITE_ENABLE_FTS5</a>
</li></ul>
-<p align="center"><small><i>This page last modified on <a href="https://sqlite.org/docsrc/honeypot" id="mtimelink" data-href="https://sqlite.org/docsrc/finfo/pages/cli.in?m=b6fcfaaa3a">2024-04-16 17:22:18</a> UTC </small></i></p>
+