From 3eb19650bb6321ba6c1fc76086c63048fba3f5ba Mon Sep 17 00:00:00 2001 From: Patrick Donnelly Date: Mon, 15 Aug 2022 11:05:21 -0400 Subject: [PATCH] doc: document debugging for libcephsqlite Fixes: https://tracker.ceph.com/issues/57127 Signed-off-by: Patrick Donnelly --- doc/rados/api/libcephsqlite.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) 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 -- 2.39.5