Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

New sentence, new line.

Browse Source 
Sort descriptions.
Use simpler markup.
Bump date for previous.
This commit is contained in:
wiz 2012-03-19 09:13:33 +00:00
parent 3a662fafc9
commit 34e2e47694
1 changed files with 19 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
external/gpl3/binutils/usr.sbin/dbsym/dbsym.8 vendored
View File

@ -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 newly linked kernel into the
.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, the
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 symbol table and the size of the
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 ,