From bb660fde50204c90862bb86281afce93f669d297 Mon Sep 17 00:00:00 2001 From: ru Date: Fri, 26 Oct 2001 11:16:18 +0000 Subject: mdoc(7) police: - Bump document date. - Remove hard sentence breaks. - Fix markup. --- usr.sbin/config/config.8 | 87 +++++++++++++++++++++++++++--------------------- 1 file changed, 49 insertions(+), 38 deletions(-) (limited to 'usr.sbin/config/config.8') diff --git a/usr.sbin/config/config.8 b/usr.sbin/config/config.8 index 9eeab24..9d21e6b 100644 --- a/usr.sbin/config/config.8 +++ b/usr.sbin/config/config.8 @@ -32,7 +32,7 @@ .\" @(#)config.8 8.2 (Berkeley) 4/19/94 .\" $FreeBSD$ .\" -.Dd April 19, 1994 +.Dd July 4, 2001 .Dt CONFIG 8 .Os .Sh NAME @@ -49,7 +49,9 @@ This is the old version of the program. It understands the old autoconfiguration scheme used on the HP300, i386, DECstation, and derivative platforms. -The new version of config is used with the +The new version of +.Nm +is used with the SPARC platform. Only the version of .Nm @@ -72,13 +74,14 @@ that give alternate files for a specific machine section below). .Pp Available options and operands: -.Bl -tag -width SYSTEM_NAME +.Bl -tag -width ".Ar SYSTEM_NAME" .It Fl d Ar destdir Use .Ar destdir as the output directory, instead of the default one. -Note -that config does not append +Note that +.Nm +does not append .Ar SYSTEM_NAME to the directory given. .It Fl g @@ -103,14 +106,14 @@ and other system parameters for one system configuration. should be run from the .Pa conf subdirectory of the system source (usually -.Pa /sys/ARCH/conf ) , +.Pa /sys/ Ns Va ARCH Ns Pa /conf ) , where -.Pa ARCH +.Va ARCH represents one of the architectures supported by .Fx . .Nm creates the directory -.Pa ../compile/SYSTEM_NAME +.Pa ../compile/ Ns Ar SYSTEM_NAME or the one given with the .Fl d option @@ -148,22 +151,26 @@ should be run again. Attempts to compile a system that had configuration errors are likely to fail. .Pp -If the option "INCLUDE_CONFIG_FILE" is used in the configuration file the -entire input file is embedded in the new kernel. This means that +If the +.Cd "options INCLUDE_CONFIG_FILE" +is used in the configuration file the +entire input file is embedded in the new kernel. +This means that .Xr strings 1 can be used to extract it from a kernel: to extract the configuration information, use the command -.Bd -literal -strings kernel | grep ___ -.Ed +.Pp +.Dl "strings kernel | grep ___" .Sh DEBUG KERNELS Traditional .Bx kernels compiled without symbols due to the heavy load on the system when compiling a .Dq debug -kernel. A debug kernel contains complete symbols for all the source files, and -enables an experienced kernel programmer to analyse the cause of a problem. The +kernel. +A debug kernel contains complete symbols for all the source files, and +enables an experienced kernel programmer to analyse the cause of a problem. +The debuggers available prior to .Bx 4.4 Lite were able to find some information @@ -177,56 +184,60 @@ default with .Fx : 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 +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, +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 -.Nm kernel.debug +.Pa kernel.debug is the complete debug kernel. .It -.Nm kernel -is a copy of the kernel with the debug symbols stripped off. This is equivalent +.Pa kernel +is a copy of the kernel with the debug symbols stripped off. +This is equivalent to the normal non-debug kernel. .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 +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 -.Nm make -.Ar install +.Dq Li "make install" installs -.Nm kernel +.Pa kernel in the root file system. .It -.Nm make -.Ar install.debug +.Dq Li "make install.debug" installs -.Nm kernel.debug +.Pa kernel.debug in the root file system. .El .Sh FILES -.Bl -tag -width /sys/ARCH/compile/LOCAL -compact +.Bl -tag -width ".Pa /sys/ Ns Va ARCH Ns Pa /compile/ Ns Ar SYSTEM_NAME" -compact .It Pa /sys/conf/files list of common files system is built from -.It Pa /sys/conf/Makefile.ARCH -generic Makefile for the -.Pa ARCH . -.It Pa /sys/conf/files.ARCH +.It Pa /sys/conf/Makefile. Ns Va ARCH +generic makefile for the +.Va ARCH +.It Pa /sys/conf/files. Ns Va ARCH list of -.Pa ARCH +.Va ARCH specific files -.It Pa /sys/ARCH/compile/LOCAL +.It Pa /sys/ Ns Va ARCH Ns Pa /compile/ Ns Ar SYSTEM_NAME default kernel build directory for system -.Pa LOCAL +.Ar SYSTEM_NAME on -.Pa ARCH . +.Va ARCH . .El .Sh SEE ALSO The -- cgit v1.1