From 82d771d8a9607df7e814809d509761c7d7c86309 Mon Sep 17 00:00:00 2001 From: Russ Allbery Date: Mon, 19 Nov 2007 03:55:32 +0000 Subject: [PATCH] * Add more debugging and bug reporting instructions to README.Debian. --- debian/README.Debian | 25 +++++++++++++++++++++++-- debian/changelog | 6 ++++++ 2 files changed, 29 insertions(+), 2 deletions(-) diff --git a/debian/README.Debian b/debian/README.Debian index 5a0c0bf51..5c3b44fc3 100644 --- a/debian/README.Debian +++ b/debian/README.Debian @@ -74,7 +74,7 @@ Changes Relative to Stock OpenAFS The OpenAFS PAM modules have been built with pthreads rather than the standard LWP AFS libraries for compatibility with a threaded sshd. -Debugging +Debugging and Bug Reporting The current OpenAFS installation process installs fileserver and volserver unstripped, since backtraces and other debugging information @@ -89,6 +89,27 @@ Debugging for all OpenAFS binaries. This is pending upstream changes to the stock OpenAFS installation rules. + When reporting a bug in the OpenAFS client, please include your exact + kernel version and architecture (reportbug will do this for you). Also, + if the client caused a kernel oops or BUG, be sure to include the + complete kernel output, including the lines before the oops. That's + where the OpenAFS error message, if any, will be. + + When reporting a bug in the OpenAFS file server, please include + backtrace information from a core dump, if any. If the file server is + deadlocked, you can capture a core dump using the gcore script that + comes with the gdb package. The file server is threaded, so use the + command "thread apply all backtrace" in gdb to get a complete backtrace. + It's also often useful to have the output of rxdebug 7000 at + the time of the problem and the FileLog from the file server. You can + increase the logging level of the file server with kill -TSTP (and reset + it to 0 with kill -HUP). + + You can report any bug in OpenAFS against the Debian package with + reportbug and the OpenAFS package maintainers will forward the bug + upstream as necessary. If you do want to report a bug directly + upstream, see http://www.openafs.org/ for bug reporting instructions. + PAM Authentication Any new OpenAFS cell is strongly encouraged to use Kerberos v5 for @@ -138,4 +159,4 @@ PAM Authentication the openafs-kpasswd package to get the administrative utilities for managing those Kerberos accounts. - -- Russ Allbery , Tue, 26 Sep 2006 16:32:58 z + -- Russ Allbery , Sun, 18 Nov 2007 19:57:23 -0800 diff --git a/debian/changelog b/debian/changelog index a71a55fbf..b95105d4e 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,9 @@ +openafs (1.4.5.dfsg1-2) UNRELEASED; urgency=low + + * Add more debugging and bug reporting instructions to README.Debian. + + -- Russ Allbery Sun, 18 Nov 2007 19:57:53 -0800 + openafs (1.4.5.dfsg1-1) unstable; urgency=low * New upstream release. -- 2.39.5