From: Daira Hopwood Date: Thu, 5 Sep 2013 17:08:50 +0000 (+0100) Subject: Sat Mar 31 23:39:34 BST 2012 david-sarah@jacaranda.org X-Git-Url: https://git.rkrishnan.org/somewhere?a=commitdiff_plain;h=d0f56a21eb73647cad6c9beff60af61fda1c5b3a;p=tahoe-lafs%2Ftahoe-lafs.git Sat Mar 31 23:39:34 BST 2012 david-sarah@jacaranda.org * Document PYTHONPATH problem when running flogtool. refs #1693 --- diff --git a/docs/logging.rst b/docs/logging.rst index 5a24700e..9609de45 100644 --- a/docs/logging.rst +++ b/docs/logging.rst @@ -23,12 +23,16 @@ record information about what is happening inside the Tahoe node. This is primarily for use by programmers and grid operators who want to find out what went wrong. -The foolscap logging system is documented at +The Foolscap logging system is documented at ``_. -The foolscap distribution includes a utility named "``flogtool``" (usually at -``/usr/bin/flogtool`` on Unix) which is used to get access to many foolscap -logging features. +The Foolscap distribution includes a utility named "``flogtool``" that is +used to get access to many Foolscap logging features. However, using this +command directly on Tahoe log files may fail, due to use of an incorrect +PYTHONPATH. Installing Foolscap v0.6.1 or later and then running +``bin/tahoe @flogtool`` from the root of a Tahoe-LAFS source distribution +may avoid this problem (but only on Unix, not Windows). + Realtime Logging ================