config.8 update

Francis GUDIN fgudin at nerim.net
Sun Feb 26 12:23:23 PST 2006


Hello,

Here's an attempt at making config(8) up to date regarding debugging
kernels.
This is my very first try at using mdoc: comments are appreciated !  

Regards,
Francis.
--- /repo/src/usr.sbin/config/config.8	2006-02-24 00:37:48.000000000 +0100
+++ config.8	2006-02-26 20:58:55.000000000 +0100
@@ -187,49 +187,26 @@
 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




More information about the Submit mailing list