18a5822eff
They are used as build tools for cross compilation. This import does not include the full distribution. Rather, it sports a shell script that will download and patch the distribution when compiled from /usr/src/tools (yet to be committed). This part of the source tree is only necessary for cross compilation. It's not used or compiled for native builds.
67 lines
1.6 KiB
Groff
67 lines
1.6 KiB
Groff
.\" $NetBSD: dbsym.8,v 1.3 2012/03/19 09:13:33 wiz Exp $
|
|
.\"
|
|
.Dd March 19, 2012
|
|
.Dt DBSYM 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm dbsym
|
|
.Nd copy kernel symbol table into db_symtab space
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl pv
|
|
.Op Fl b Ar bfdname
|
|
.Ar kernel
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
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
|
|
on systems for which the boot program does not load the symbol table
|
|
into memory with the kernel.
|
|
The space for these symbols is
|
|
reserved in the data segment using a config option like:
|
|
.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
|
|
is reserved, dbsym will refuse to copy the symbol table.
|
|
.Pp
|
|
To recognize kernel executable format, the
|
|
.Fl b
|
|
flag specifies BFD name of kernel.
|
|
.Pp
|
|
If the
|
|
.Fl p
|
|
flag is given,
|
|
.Nm
|
|
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
|
|
either compile the kernel without debugging symbols (no
|
|
.Fl g
|
|
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
|
|
.Dl strip -d netbsd
|
|
will strip out debugging symbols.
|
|
.Sh SEE ALSO
|
|
.Xr strip 1 ,
|
|
.Xr ddb 4
|