From owner-freebsd-doc  Sun Oct 15  5:20: 8 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 1C8D937B67B
	for <freebsd-doc@freebsd.org>; Sun, 15 Oct 2000 05:20:01 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id FAA11481;
	Sun, 15 Oct 2000 05:20:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from numeri.campus.luth.se (numeri.campus.luth.se [130.240.197.103])
	by hub.freebsd.org (Postfix) with ESMTP id 06B5737B670
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 15 Oct 2000 05:16:57 -0700 (PDT)
Received: (from k@localhost)
	by numeri.campus.luth.se (8.9.3/8.9.3) id OAA65824;
	Sun, 15 Oct 2000 14:17:59 +0200 (CEST)
	(envelope-from k)
Message-Id: <200010151217.OAA65824@numeri.campus.luth.se>
Date: Sun, 15 Oct 2000 14:17:59 +0200 (CEST)
From: Johan Karlsson <k@numeri.campus.luth.se>
Reply-To: k@numeri.campus.luth.se
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/21999: [PATCH] Ask for numeric-sorted nm(1) output in FAQ. 
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         21999
>Category:       docs
>Synopsis:       [PATCH] Ask for numeric-sorted nm(1) output in FAQ.
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Oct 15 05:20:00 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Johan Karlsson
>Release:        FreeBSD 4.1-STABLE i386
>Organization:
>Environment:

	

>Description:
	
	In the FAQ section 'For serious FreeBSD hackers only'
	question 'Making the most of a kernel panic' we currently
	ask for alphabetic-sorted output from nm(1).

	When trying to debug the panic it is alot easier to find 
	the instruction address if the output is numeric-sorted.

>How-To-Repeat:
>Fix:

	Tell the user to use 'nm -n /kernel.that....' instead.


Index: doc/en_US.ISO_8859-1/books/faq/book.sgml
===================================================================
RCS file: /usr/home/ncvs/doc/en_US.ISO_8859-1/books/faq/book.sgml,v
retrieving revision 1.110
diff -u -r1.110 book.sgml
--- doc/en_US.ISO_8859-1/books/faq/book.sgml	2000/10/12 20:36:03	1.110
+++ doc/en_US.ISO_8859-1/books/faq/book.sgml	2000/10/15 12:04:41
@@ -10939,7 +10939,7 @@
               <listitem>
                 <para>When the system reboots, do the following:
 
-                  <screen>&prompt.user; <userinput>nm /kernel.that.caused.the.panic | grep f0xxxxxx</userinput></screen>
+                  <screen>&prompt.user; <userinput>nm -n /kernel.that.caused.the.panic | grep f0xxxxxx</userinput></screen>
 
                   where <literal>f0xxxxxx</literal> is the instruction
                   pointer value. The odds are you will not get an exact
@@ -10950,7 +10950,7 @@
                   last digit from the instruction pointer value and try
                   again, i.e.:
 
-                  <screen>&prompt.user; <userinput>nm /kernel.that.caused.the.panic | grep f0xxxxx</userinput></screen>
+                  <screen>&prompt.user; <userinput>nm -n /kernel.that.caused.the.panic | grep f0xxxxx</userinput></screen>
 
                    If that doesn't yield any results, chop off another
                    digit. Repeat until you get some sort of output. The

>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message