From: Patrick Donnelly Date: Mon, 15 Aug 2022 15:05:21 +0000 (-0400) Subject: doc: document debugging for libcephsqlite X-Git-Tag: v18.0.0~242^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F47600%2Fhead;p=ceph.git doc: document debugging for libcephsqlite Fixes: https://tracker.ceph.com/issues/57127 Signed-off-by: Patrick Donnelly --- diff --git a/doc/rados/api/libcephsqlite.rst b/doc/rados/api/libcephsqlite.rst index 76ab306bb1b53..beee4a466a34e 100644 --- a/doc/rados/api/libcephsqlite.rst +++ b/doc/rados/api/libcephsqlite.rst @@ -426,6 +426,22 @@ the asynchronous writes as well as an asynchronous update to the size of the striped file. +Debugging +^^^^^^^^^ + +Debugging libcephsqlite can be turned on via:: + + debug_cephsqlite + +If running the ``sqlite3`` command-line tool, use: + +.. code:: sh + + env CEPH_ARGS='--log_to_file true --log-file sqlite3.log --debug_cephsqlite 20 --debug_ms 1' sqlite3 ... + +This will save all the usual Ceph debugging to a file ``sqlite3.log`` for inspection. + + .. _SQLite: https://sqlite.org/index.html .. _SQLite VFS: https://www.sqlite.org/vfs.html .. _SQLite Backup: https://www.sqlite.org/backup.html