1.\" Copyright (c) 1980, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by the University of 15.\" California, Berkeley and its contributors. 16.\" 4. Neither the name of the University nor the names of its contributors 17.\" may be used to endorse or promote products derived from this software 18.\" without specific prior written permission. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)config.8 8.2 (Berkeley) 4/19/94 33.\" $FreeBSD: src/usr.sbin/config/config.8,v 1.21.2.7 2003/04/23 07:32:39 brueffer Exp $ 34.\" $DragonFly: src/usr.sbin/config/config.8,v 1.5 2006/02/26 23:27:08 swildner Exp $ 35.\" 36.Dd July 4, 2001 37.Dt CONFIG 8 38.Os 39.Sh NAME 40.Nm config 41.Nd build system configuration files 42.Sh SYNOPSIS 43.Nm 44.Op Fl gpr 45.Op Fl d Ar destdir 46.Ar SYSTEM_NAME 47.Sh DESCRIPTION 48This is the old version of the 49.Nm 50program. 51It understands the old autoconfiguration scheme 52used on the HP300, i386, DECstation, and derivative platforms. 53The new version of 54.Nm 55is used with the 56SPARC platform. 57Only the version of 58.Nm 59applicable to the architecture that you are running 60will be installed on your machine. 61.Pp 62The 63.Nm 64utility builds a set of system configuration files from the file 65.Ar SYSTEM_NAME 66which describes 67the system to configure. 68A second file 69tells 70.Nm 71what files are needed to generate a system and 72can be augmented by configuration specific set of files 73that give alternate files for a specific machine 74(see the 75.Sx FILES 76section below). 77.Pp 78Available options and operands: 79.Bl -tag -width ".Ar SYSTEM_NAME" 80.It Fl d Ar destdir 81Use 82.Ar destdir 83as the output directory, instead of the default one. 84Note that 85.Nm 86does not append 87.Ar SYSTEM_NAME 88to the directory given. 89.It Fl g 90Configure a system for debugging. 91.It Fl p 92Configure a system for profiling; for example, 93.Xr kgmon 8 94and 95.Xr gprof 1 . 96If two or more 97.Fl p 98options are supplied, 99.Nm 100configures a system for high resolution profiling. 101.It Fl r 102Remove the old compile directory (see below). 103.It Ar SYSTEM_NAME 104Specify the name of the system configuration file 105containing device specifications, configuration options 106and other system parameters for one system configuration. 107.El 108.Pp 109.Nm 110should be run from the 111.Pa conf 112subdirectory of the system source (usually 113.Pa /sys/ Ns Va ARCH Ns Pa /conf ) , 114where 115.Va ARCH 116represents one of the architectures supported by 117.Dx . 118.Nm 119creates the directory 120.Pa ../../compile/ Ns Ar SYSTEM_NAME 121or the one given with the 122.Fl d 123option 124as necessary and places all output files there. 125If the output directory already exists and the 126.Fl r 127flag was specified, it will be removed first. 128The output of 129.Nm 130consists of a number of files; for the 131.Tn i386 , 132they are: 133.Pa ioconf.c , 134a description 135of what I/O devices are attached to the system; 136.Pa Makefile , 137used by 138.Xr make 1 139in building the system; 140header files, 141definitions of 142the number of various devices that will be compiled into the system. 143.Pp 144After running 145.Nm , 146it is necessary to run 147.Dq Li make depend 148in the directory where the new makefile 149was created. 150The 151.Nm 152utility prints a reminder of this when it completes. 153.Pp 154If any other error messages are produced by 155.Nm , 156the problems in the configuration file should be corrected and 157.Nm 158should be run again. 159Attempts to compile a system that had configuration errors 160are likely to fail. 161.Pp 162If the 163.Cd "options INCLUDE_CONFIG_FILE" 164is used in the configuration file the 165entire input file is embedded in the new kernel. 166This means that 167.Xr strings 1 168can be used to extract it from a kernel: 169to extract the configuration information, use the command 170.Pp 171.Dl "strings -n 3 kernel | sed -n 's/^___//p'" 172.Sh DEBUG KERNELS 173Traditional 174.Bx 175kernels are compiled without symbols due to the heavy load on the 176system when compiling a 177.Dq debug 178kernel. 179A debug kernel contains complete symbols for all the source files, and 180enables an experienced kernel programmer to analyse the cause of a problem. 181The 182debuggers available prior to 183.Bx 4.4 Lite 184were able to find some information 185from a normal kernel; 186.Xr gdb 1 187provides very little support for normal kernels, and a debug kernel is needed 188for any meaningful analysis. 189.Pp 190In order to ease posting bug reports for inexperienced users and 191make the debugging environment more uniform, 192.Dx 193installs kernel and modules unstripped. 194Debug information is not loaded into memory, so the only impact is 195a minor growth in root file-system consumption by 10MB. 196Those wishing to install stripped down kernel and modules can specify two new 197makeoptions in their kernel config file or when they run the 198kernel-related targets to make: 199.Bl -tag -width ".Va INSTALLSTRIPPEDMODULES=1" 200.It Va INSTALLSTRIPPED=1 201The installed kernel and modules will be stripped of debug info. 202.It Va INSTALLSTRIPPEDMODULES=1 203The installed modules will be stripped of debug info. The kernel will 204be left with debug info intact. 205.El 206.Pp 207Backup copies of the kernel and modules are automatically stripped of 208their debug information by 209.Xr objcopy 1 . 210.Sh FILES 211.Bl -tag -width ".Pa /sys/ Ns Va ARCH Ns Pa /conf/files. Ns Ar SYSTEM_NAME" -compact 212.It Pa /sys/conf/files 213list of common files system is built from 214.It Pa /sys/conf/Makefile. Ns Va ARCH 215generic makefile for the 216.Va ARCH 217.It Pa /sys/conf/files. Ns Va ARCH 218list of 219.Va ARCH 220specific files 221.It Pa /sys/ Ns Va ARCH Ns Pa /conf/files. Ns Ar SYSTEM_NAME 222list of files specific to 223.Ar SYSTEM_NAME 224on 225.Va ARCH 226.It Pa /sys/compile/ Ns Ar SYSTEM_NAME 227default kernel build directory for system 228.Ar SYSTEM_NAME . 229.El 230.Sh SEE ALSO 231The 232.Sx SYNOPSIS 233portion of each device in section 4. 234.Rs 235.%T "Building 4.3 BSD UNIX System with Config" 236.Re 237.Sh HISTORY 238The 239.Nm 240utility appeared in 241.Bx 4.1 . 242.Sh BUGS 243The line numbers reported in error messages are usually off by one. 244