Project

General

Profile

Bug #99 ยป src_usr.sbin_config_config.8.diff

fgudin, 02/26/2006 08:28 PM

View differences:

config.8 2006-02-26 20:58:55.000000000 +0100
provides very little support for normal kernels, and a debug kernel is needed
for any meaningful analysis.
.Pp
For reasons of history, time and space, building a debug kernel is not the
default with
.Dx :
a debug kernel takes up to 30% longer to build and
requires about 30 MB of disk storage in the build directory, compared to about 6
MB for a non-debug kernel.
A debug kernel is about 11 MB in size, compared to
about 2 MB for a non-debug kernel.
This space is used both in the root file
system and at run time in memory.
Use the
.Fl g
option to build a debug kernel.
With this option,
.Nm
causes two kernel files to be built in the kernel build directory:
.Bl -bullet
.It
.Pa kernel.debug
is the complete debug kernel.
.It
.Pa kernel
is a copy of the kernel with the debug symbols stripped off.
This is equivalent
to the normal non-debug kernel.
In order to ease posting bug reports for inexperienced users and
make the debugging environment more uniform,
.Dx
installs kernel and modules unstripped.
Debug information is not loaded into memory, so the only impact is
a minor growth in root file-system consumption by 10MB.
Those wishing to install stripped down kernel and modules can specify two new
makeoptions in their kernel config file or when they run the
kernel-related targets to make:
.Bl -tag -width ".Ar INSTALLSTRIPPEDMODULES=1"
.It INSTALLSTRIPPED=1
The installed kernel and modules will be stripped of debug info.
.It INSTALLSTRIPPEDMODULES=1
The installed modules will be stripped of debug info. The kernel will
be left with debug info intact.
.El
.Pp
There is currently little sense in installing and booting from a debug kernel,
since the only tools available which use the symbols do not run on-line.
There
are therefore two options for installing a debug kernel:
.Bl -bullet
.It
.Dq Li "make install"
installs
.Pa kernel
in the root file system.
.It
.Dq Li "make install.debug"
installs
.Pa kernel.debug
in the root file system.
.El
Backup copies of the kernel and modules are automatically stripped of
their debug information by
.Xr objcopy 1 .
.Sh FILES
.Bl -tag -width ".Pa /sys/ Ns Va ARCH Ns Pa /conf/files. Ns Ar SYSTEM_NAME" -compact
.It Pa /sys/conf/files
    (1-1/1)