Module Name: src
Committed By: wiz
Date: Mon Mar 19 09:13:33 UTC 2012
Modified Files:
src/external/gpl3/binutils/usr.sbin/dbsym: dbsym.8
Log Message:
New sentence, new line.
Sort descriptions.
Use simpler markup.
Bump date for previous.
To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/external/gpl3/binutils/usr.sbin/dbsym/dbsym.8
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/external/gpl3/binutils/usr.sbin/dbsym/dbsym.8
diff -u src/external/gpl3/binutils/usr.sbin/dbsym/dbsym.8:1.2 src/external/gpl3/binutils/usr.sbin/dbsym/dbsym.8:1.3
--- src/external/gpl3/binutils/usr.sbin/dbsym/dbsym.8:1.2 Mon Mar 19 05:38:26 2012
+++ src/external/gpl3/binutils/usr.sbin/dbsym/dbsym.8 Mon Mar 19 09:13:33 2012
@@ -1,6 +1,6 @@
-.\" $NetBSD: dbsym.8,v 1.2 2012/03/19 05:38:26 bsh Exp $
+.\" $NetBSD: dbsym.8,v 1.3 2012/03/19 09:13:33 wiz Exp $
.\"
-.Dd November 9, 2001
+.Dd March 19, 2012
.Dt DBSYM 8
.Os
.Sh NAME
@@ -17,15 +17,16 @@ is used to copy the symbol table in a ne
.Va db_symtab
array (in the data section) so that the
.Xr ddb 4
-kernel debugger can find the symbols. This program is only used
+kernel debugger can find the symbols.
+This program is only used
on systems for which the boot program does not load the symbol table
-into memory with the kernel. The space for these symbols is
+into memory with the kernel.
+The space for these symbols is
reserved in the data segment using a config option like:
-.Pp
-.Li options SYMTAB_SPACE=72000
-.Pp
+.Dl options SYMTAB_SPACE=72000
The size of the db_symtab array (the value of SYMTAB_SPACE) must be
-at least as large as the kernel symbol table. If insufficient space
+at least as large as the kernel symbol table.
+If insufficient space
is reserved, dbsym will refuse to copy the symbol table.
.Pp
To recognize kernel executable format, the
@@ -33,13 +34,6 @@ To recognize kernel executable format, t
flag specifies BFD name of kernel.
.Pp
If the
-.Fl v
-flag is given,
-.Nm
-will print out status information as
-it is copying the symbol table.
-.Pp
-If the
.Fl p
flag is given,
.Nm
@@ -47,6 +41,13 @@ will report the size of the kernel symbo
db_symtab space.
Two values are printed out in a line separated by a space.
.Pp
+If the
+.Fl v
+flag is given,
+.Nm
+will print out status information as
+it is copying the symbol table.
+.Pp
Note that debugging symbols are not useful to the
.Xr ddb 4
kernel debugger, so to minimize the size of the kernel, one should
@@ -56,10 +57,9 @@ flag) or use the
.Xr strip 1
command to strip debugging symbols from the kernel before
.Nm
-is used to copy the symbol table. The command
-.Pp
-.Li strip -d netbsd
-.Pp
+is used to copy the symbol table.
+The command
+.Dl strip -d netbsd
will strip out debugging symbols.
.Sh SEE ALSO
.Xr strip 1 ,
