From owner-man-jp@jp.freebsd.org  Thu Jan 13 01:54:16 2000
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id BAA69780;
	Thu, 13 Jan 2000 01:54:16 +0900 (JST)
	(envelope-from owner-man-jp@jp.FreeBSD.org)
Received: from tasogare.imasy.or.jp (mistral@tasogare.imasy.or.jp [202.227.24.5])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id BAA69775
	for <man-jp@jp.freebsd.org>; Thu, 13 Jan 2000 01:54:16 +0900 (JST)
	(envelope-from mistral@imasy.or.jp)
Received: from mistral.wind.prv (isdn42.imasy.or.jp [202.227.24.234])
	by tasogare.imasy.or.jp (8.9.3+3.2W/3.7W-tasogare/smtpfeed 1.01) with ESMTP id BAA15325
	for <man-jp@jp.freebsd.org>; Thu, 13 Jan 2000 01:54:13 +0900 (JST)
	(envelope-from mistral@imasy.or.jp)
Message-Id: <200001121654.BAA15325@tasogare.imasy.or.jp>
Received: (from yohta@localhost)
	by mistral.wind.prv (8.9.3/3.7Wpl2-990626) id BAA01533;
	Thu, 13 Jan 2000 01:49:11 +0900 (JST)
Date: Thu, 13 Jan 2000 01:49:11 +0900 (JST)
From: mistral@imasy.or.jp (Yoshihiko SARUMARU)
To: man-jp@jp.freebsd.org
In-Reply-To: Your message of "Thu, 13 Jan 2000 00:51:47 +0900 (JST)".
	<200001121551.AAA27324@tasogare.imasy.or.jp>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-2022-JP
X-Mailer: mnews [version 1.22] 1999-12/19(Sun)
Reply-To: man-jp@jp.freebsd.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+990727
X-Sequence: man-jp 2133
Subject: [man-jp 2133] Re: Current status (4.0-20000105-CURRENT update)
Errors-To: owner-man-jp@jp.freebsd.org
Sender: owner-man-jp@jp.freebsd.org
X-Originator: mistral@imasy.or.jp

$B!!1n4]$G$9!#(B

2000-01-13($BLZ(B) 00:51:47.$B:"!";d$O=q$-$^$7$?!#(B

> 2000-01-12($B?e(B) 20:33:03.$B:"!"(Bk-horik@yk.rim.or.jp$B$5$s$O=q$-$^$7$?!#(B
> 
> > 		make.1		849
> > 		config.8	146
> 
>   $B$H$j$"$($:!"$3$l$d$j$^$9!#(B

  $B$H$j$"$($:(B config.8 $B$N:9J,$G$9!#(B

--
$B1n4](B($B5l@+(B: $BB@ED(B)$BK'I'(B (Yoshihiko SARUMARU)
mail: mistral@imasy.or.jp	web: http://www.imasy.or.jp/~mistral/

--- 3.4-jp/config.8	Wed Sep  1 00:25:30 1999
+++ 4.0-jp/config.8	Thu Jan 13 01:41:28 2000
@@ -30,6 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)config.8	8.2 (Berkeley) 4/19/94
+.\" %FreeBSD: src/usr.sbin/config/config.8,v 1.18 1999/10/30 10:55:47 marcel Exp %
 .\"
 .\" Original Revision: 1.10
 .\" jpman %Id: config.8,v 1.2 1997/03/31 13:33:05 horikawa Stab %
@@ -43,6 +44,7 @@
 .Sh $B=q<0(B
 .Nm config
 .Op Fl gpr
+.Op Fl d Ar destdir
 .Ar SYSTEM_NAME
 .Sh $B2r@b(B
 $B$3$l$O8E$$%P!<%8%g%s$N(B
@@ -73,6 +75,12 @@
 $B%*%W%7%g%s$H%*%Z%i%s%I$7$F$O0J2<$N$b$N$,$"$j$^$9(B:
 .Pp
 .Bl -tag -width SYSTEM_NAME
+.It Fl d Ar destdir
+$B%G%U%)%k%H$N=PNO%G%#%l%/%H%j$NBe$o$j$K!"(B
+.Ar destdir
+$B$K=PNO$7$^$9!#(Bconfig $B$OM?$($i$l$?%G%#%l%/%H%j$K(B
+.Ar SYSTEM_NAME
+$B$rDI2C$7$J$$$3$H$KCm0U$7$F$/$@$5$$!#(B
 .It Fl g
 $B%7%9%F%`$N%G%P%C%0$N$?$a$N@_Dj$r$7$^$9!#(B
 .It Fl p
@@ -98,12 +106,18 @@
 .Pa conf
 $B%5%V%G%#%l%/%H%j$G5/F0$7$^$9(B ($BDL>o(B
 .Pa /sys/ARCH/conf
-)$B!#(B
+),
+$B$?$@$7(B
+.Pa ARCH
+$B$K$O(B FreeBSD $B$,%5%]!<%H$7$F$$$k%"!<%-%F%/%A%c$N0l$D$,F~$j$^$9!#(B
 .Nm
 $B$OI,MW$K$h$j(B
 .Pa ../../compile/SYSTEM_NAME
-$B%G%#%l%/%H%j$r:n@.$7!"$=$3$K$9$Y$F$N=PNO%U%!%$%k$rCV$-$^$9!#(B
-$B%G%#%l%/%H%j$,4{$KB8:_$7!"(B
+$B$+!"$^$?$O(B
+.Fl d
+$B%*%W%7%g%s$G;XDj$5$l$?%G%#%l%/%H%j(B
+$B$r:n@.$7!"$=$3$K$9$Y$F$N=PNO%U%!%$%k$rCV$-$^$9!#(B
+$B=PNO%G%#%l%/%H%j$,4{$KB8:_$7!"(B
 .Fl r
 $B%*%W%7%g%s$,;XDj$5$l$F$$$k>l9g!"(B
 $B%G%#%l%/%H%j$,$^$::o=|$5$l$^$9!#(B
@@ -144,9 +158,61 @@
 $B3:%U%!%$%kA4BN$,:n@.$5$l$k%+!<%M%k$KKd$a9~$^$l$^$9!#(B
 $B$3$l$O!"(B
 .Xr strings 1
-$B$K$h$C$F3:%U%!%$%k$r%+!<%M%k$+$i0z$-=P$9;v$,=PMh$k$3$H$r0UL#$7$^$9!#(B
+$B$K$h$C$F3:%U%!%$%k$r%+!<%M%k$+$i0z$-=P$9;v$,=PMh$k$3$H$r0UL#$7$^$9(B:
+$B9=@.>pJs$rCj=P$9$k$K$O0J2<$N%3%^%s%I$r;HMQ$7$F$/$@$5$$(B:
+.Bd -literal
+strings kernel | grep ___
+.Ed
+.Sh $B%G%P%C%0%+!<%M%k(B
+.if n "$B%G%P%C%0(B"
+.if t ``$B%G%P%C%0(B''
+$B%+!<%M%k$r%3%s%Q%$%k$9$k$3$H$O%7%9%F%`$K$R$I$/Ii2Y$r3]$1$k$?$a!"(B
+$BEAE}E*$J(B BSD $B%+!<%M%k$O%7%s%\%k$r=|$$$F%3%s%Q%$%k$5$l$F$-$^$7$?!#(B
+$B%G%P%C%0%+!<%M%k$OA4$F$N%=!<%9%U%!%$%k$N40A4$J%7%s%\%k$r;}$C$F$$$k$?$a!"(B
+$B7P83$r@Q$s$@%+!<%M%k%W%m%0%i%^$,LdBj$N860x$r2r@O$G$-$k$h$&$K$J$j$^$9!#(B
+4.4BSD-Lite $B0JA0$+$i$"$C$?%G%P%C%,$ODL>o$N%+!<%M%k$+$i$O$"$^$j>pJs$r(B
+$B8+$D$1$i$l$^$;$s$G$7$?(B;
+.Xr gdb 1
+$B$ODL>o$N%+!<%M%k$+$i$O$[$H$s$I>pJs$rF@$k$3$H$O$G$-$:!"(B
+$B0U5A$N$"$k2r@O$r9T$J$&$K$O!"%G%P%C%0%+!<%M%k$,I,MW$G$9!#(B
+.Pp
+$BNr;K$H;~4V!"%9%Z!<%9$NLdBj$G!"(BFreeBSD $B$O%G%U%)%k%H$G$O%G%P%C%0%+!<%M%k$r(B
+$B9=C[$7$^$;$s!#%G%P%C%0%+!<%M%k$O9=C[$K(B 30% $B6a$/D9$/3]$+$j!"(B
+$B%G%P%C%0MQ$G$J$$%+!<%M%k$G$OLs(B 6 MB $B$G:Q$`$H$3$m$r!"(B
+$B9=C[MQ%G%#%l%/%H%j$KLs(B 30 MB $B$N%G%#%9%/MFNL$rI,MW$H$7$^$9!#(B
+$B%G%P%C%0%+!<%M%k$O%G%P%C%0MQ$G$J$$%+!<%M%k$,Ls(B 2MB $B$G$"$k$N$KBP$7$F!"(B
+$BLs(B 11 MB $B$N%5%$%:$K$J$j$^$9!#$3$N%9%Z!<%9$O%k!<%H%U%!%$%k%7%9%F%`$H(B
+$BF0:n;~$N%a%b%j$NN>J}$K8z$$$F$-$^$9!#(B
+$B%G%P%C%0%+!<%M%k$r:n$k$K$O(B
+.Fl g
+$B%*%W%7%g%s$r;H$$$^$9!#$3$N%*%W%7%g%s$rMQ$$$k$H!"(B
+.Nm
+$B$O%+!<%M%k9=C[%G%#%l%/%H%j$K(B 2 $B$D$N%U%!%$%k$r9=C[$7$^$9(B:
+.Bl -bullet
+.It
+.Nm kernel.debug
+$B$,40A4$J%G%P%C%0%+!<%M%k$G$9!#(B
+.It
+.Nm kernel
+$B$O%+!<%M%k$N%G%P%C%0%7%s%\%k$r:o=|$7$?%3%T!<$G$9!#(B
+$B$3$N%+!<%M%k$ODL>o$N%G%P%C%0MQ$G$J$$%+!<%M%k$HF1$8J*$G$9!#(B
+.El
 .Pp
-strings | grep ___ $B$K$h$C$F9=@.>pJs$rI=<($G$-$^$9!#(B
+$B8=:_$O%G%P%C%0%+!<%M%k$r%$%s%9%H!<%k$7$F%V!<%H$9$k0U5A$O$"$^$j$"$j$^$;$s!#(B
+$B$J$<$J$i%7%s%\%k$rMxMQ$G$-$k%D!<%k$O%*%s%i%$%s$G$OF0$+$J$$$?$a$G$9!#(B
+$B$=$l$f$(!"%G%P%C%0%+!<%M%k$r%$%s%9%H!<%k$9$k$K$O(B 2 $B$D$N%*%W%7%g%s$,$"$j$^$9!#(B
+.Bl -bullet
+.It
+.Nm make
+.Ar install
+.Nm kernel
+$B$r%k!<%H%U%!%$%k%7%9%F%`$K%$%s%9%H!<%k$7$^$9!#(B
+.It
+.Nm make
+.Ar install.debug
+.Nm kernel.debug
+$B$r%k!<%H%U%!%$%k%7%9%F%`$K%$%s%9%H!<%k$7$^$9!#(B
+.El
 .Sh $B4XO"%U%!%$%k(B
 .Bl -tag -width /sys/i386/conf/Makefile.i386 -compact
 .It Pa /sys/conf/files
@@ -157,12 +223,12 @@
 .It Pa /sys/i386/conf/files.i386
 .Tn i386
 $BFCM-$N%U%!%$%k$N%j%9%H(B
-.It Pa /sys/i386/conf/devices.i386
-.Tn i386
-$BFCM-$N!"L>A0$+$i%a%8%c!<%G%P%$%9$X$N%^%C%W(B
 .It Pa /sys/i386/conf/files. Ns Em ERNIE
 .Em ERNIE
 $B%7%9%F%`FCM-$N%U%!%$%k$N%j%9%H(B
+.It Pa /sys/compile/SYSTEM_NAME
+.Pa SYSTEM_NAME
+$B%7%9%F%`MQ$N%G%U%)%k%H%+!<%M%k9=C[%G%#%l%/%H%j(B
 .El
 .Sh $B4XO"9`L\(B
 $B%;%/%7%g%s(B 4 $B$K$"$k!"%G%P%$%9$N%^%K%e%"%k$N=q<0$NItJ,!#(B

--- 3.4/config.8	Mon Dec 20 14:52:30 1999
+++ 4.0/config.8	Wed Jan  5 23:00:41 2000
@@ -30,6 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)config.8	8.2 (Berkeley) 4/19/94
+.\" $FreeBSD: src/usr.sbin/config/config.8,v 1.18 1999/10/30 10:55:47 marcel Exp $
 .\"
 .Dd April 19, 1994
 .Dt CONFIG 8
@@ -40,6 +41,7 @@
 .Sh SYNOPSIS
 .Nm config
 .Op Fl gpr
+.Op Fl d Ar destdir
 .Ar SYSTEM_NAME
 .Sh DESCRIPTION
 This is the old version of the
@@ -72,6 +74,13 @@
 Available options and operands:
 .Pp
 .Bl -tag -width 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
+.Ar SYSTEM_NAME
+to the directory given.
 .It Fl g
 Configure a system for debugging.
 .It Fl p
@@ -83,7 +92,7 @@
 .Fl p
 options are supplied,
 .Nm
-will configure a system for high resolution profiling.
+configures a system for high resolution profiling.
 .It Fl r
 Remove the old compile directory (see below).
 .It Ar SYSTEM_NAME
@@ -96,12 +105,18 @@
 should be run from the
 .Pa conf
 subdirectory of the system source (usually
-.Pa /sys/ARCH/conf ) .
+.Pa /sys/ARCH/conf ) ,
+where
+.Pa ARCH
+represents one of the architectures supported by FreeBSD.
 .Nm Config
-will create the directory
+creates the directory
 .Pa ../../compile/SYSTEM_NAME
-as necessary and place all output files there.
-If the directory already exists and the
+or the one given with the
+.Fl d
+option 
+as necessary and places all output files there.
+If the output directory already exists and the
 .Fl r
 flag was specified, it will be removed first.
 The output of
@@ -147,9 +162,61 @@
 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
 .Xr strings 1
-can be used to extract it from a kernel. 
+can be used to extract it from a kernel:
+to extract the configuration information, use the command
+.Bd -literal
+strings kernel | grep ___
+.Ed
+.Sh DEBUG KERNELS
+Traditional BSD kernels compiled without symbols due to the heavy load on the
+system when compiling a
+.if n "debug"
+.if t ``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
+debuggers available prior to 4.4BSD-Lite were able to find some information
+from a normal kernel; 
+.Xr gdb 1
+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 FreeBSD: 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
+.Nm 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
+to the normal non-debug kernel.
+.El
 .Pp
-Strings | grep ___ will print just the configure information.
+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
+.Nm make
+.Ar install
+installs
+.Nm kernel
+in the root file system.
+.It
+.Nm make
+.Ar install.debug
+installs
+.Nm kernel.debug
+in the root file system.
+.El
 .Sh FILES
 .Bl -tag -width /sys/i386/conf/Makefile.i386 -compact
 .It Pa /sys/conf/files
@@ -161,13 +228,13 @@
 list of
 .Tn i386
 specific files
-.It Pa /sys/i386/conf/devices.i386
-name to major device mapping file for the
-.Tn i386
 .It Pa /sys/i386/conf/files. Ns Em ERNIE
 list of files specific to
 .Em ERNIE
 system
+.It Pa /sys/compile/SYSTEM_NAME
+default kernel build directory for system
+.Pa SYSTEM_NAME .
 .El
 .Sh SEE ALSO
 The SYNOPSIS portion of each device in section 4.
