1 .\" Copyright (c) 1980, 1991, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
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. Neither the name of the University nor the names of its contributors
13 .\" may be used to endorse or promote products derived from this software
14 .\" without specific prior written permission.
16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 .\" @(#)config.8 8.2 (Berkeley) 4/19/94
29 .\" $FreeBSD: src/usr.sbin/config/config.8,v 1.21.2.7 2003/04/23 07:32:39 brueffer Exp $
36 .Nd build system configuration files
45 utility builds a set of system configuration files from the file
48 the system to configure.
52 what files are needed to generate a system and
53 can be augmented by configuration specific set of files
54 that give alternate files for a specific machine
59 Available options and operands:
60 .Bl -tag -width ".Ar SYSTEM_NAME"
64 as the output directory, instead of the default one.
69 to the directory given.
71 Configure a system for debugging.
73 Remove the old compile directory (see below).
75 Specify the name of the system configuration file
76 containing device specifications, configuration options
77 and other system parameters for one system configuration.
81 should be run from the
83 subdirectory of the system source (usually
87 .Pa ../compile/ Ns Ar SYSTEM_NAME
88 or the one given with the
91 as necessary and places all output files there.
92 If the output directory already exists and the
94 flag was specified, it will be removed first.
97 consists of a number of files; for the
99 architecture, they are:
102 of what I/O devices are attached to the system;
106 in building the system;
109 the number of various devices that will be compiled into the system.
113 it is necessary to run
115 in the directory where the new makefile
118 If any other error messages are produced by
120 the problems in the configuration file should be corrected and
123 Attempts to compile a system that had configuration errors
127 .Cd "options INCLUDE_CONFIG_FILE"
128 is used in the configuration file the
129 entire input file is embedded in the new kernel.
132 can be used to extract it from a kernel:
133 to extract the configuration information, use the command
135 .Dl "strings -n 3 kernel | sed -n 's/^___//p'"
139 kernels are compiled without symbols due to the heavy load on the
140 system when compiling a
143 A debug kernel contains complete symbols for all the source files, and
144 enables an experienced kernel programmer to analyse the cause of a problem.
146 debuggers available prior to
148 were able to find some information
149 from a normal kernel;
151 provides very little support for normal kernels, and a debug kernel is needed
152 for any meaningful analysis.
154 In order to ease posting bug reports for inexperienced users and
155 make the debugging environment more uniform,
157 installs kernel and modules unstripped.
158 Debug information is not loaded into memory, so the only impact is
159 a growth in root file-system consumption by 60MB.
160 Those wishing to install stripped down kernel and modules can specify two new
161 makeoptions in their kernel config file or when they run the
162 kernel-related targets to make:
163 .Bl -tag -width ".Va INSTALLSTRIPPEDMODULES=1"
164 .It Va INSTALLSTRIPPED=1
165 The installed kernel and modules will be stripped of debug info.
166 .It Va INSTALLSTRIPPEDMODULES=1
167 The installed modules will be stripped of debug info. The kernel will
168 be left with debug info intact.
171 Backup copies of the kernel and modules are automatically stripped of
172 their debug information by
175 .Va NO_KERNEL_OLD_STRIP
179 .Bl -tag -width ".It Pa /sys/platform/ Ns Va PLATFORM Ns Pa /conf/Makefile" -compact
180 .It Pa /sys/conf/files
181 list of common files system is built from
182 .It Pa /sys/config/ Ns Ar SYSTEM_NAME
183 default location for kernel configuration file
184 .It Pa /sys/config/LINT64
185 kernel configuration file for checking all the sources,
186 includes description of kernel configuration options
187 .It Pa /sys/config/VKERNEL64
190 kernel configuration file
191 .It Pa /sys/config/X86_64_GENERIC
194 kernel configuration file
195 .It Pa /sys/compile/ Ns Ar SYSTEM_NAME
196 default kernel build directory for system
198 .It Pa /sys/platform/ Ns Va PLATFORM Ns Pa /conf/Makefile
199 generic makefile for the
201 .It Pa /sys/platform/ Ns Va PLATFORM Ns Pa /conf/files
216 portion of each device in section 4.
218 .%T "Building 4.3 BSD UNIX System with Config"
226 The line numbers reported in error messages are usually off by one.