CONFIG(8) BSD System Manager's Manual CONFIG(8)NAMEconfig - build kernel compilation directories
SYNOPSISconfig [-gpss] [-m makeoption] [-o option] system-name
DESCRIPTION
Config builds a set of configuration files from the file system-name,
which describes the system to configure.
Config should run from the conf subdirectory of the top-level machine-
specific directory of the system source (usually /sys/MACHINE/conf, where
MACHINE is one of i386, powerpc, sparc, and so forth). Config assumes
the directory ../../compile exists; it places all output files in a sub-
directory there, creating the subdirectory if necessary. The subdirecto-
ry name is taken from the system-name; thus, configuring with ``config
PICKLE'' will use the directory ../../compile/PICKLE.
The options are as follows:
-g Equivalent to ``-m DEBUG=-g'', this causes the resulting
Makefile to build a ``bsd.gdb'' file containing debugging
symbols.
-m makeoption
Inserts a makeoption as if it appeared in the configuration
file.
-o option Inserts an option as if it appeared in the configuration
file.
-p Similar to ``-m PROF=-pg -o GPROF'', but the suffix .PROF is
added to the compilation directory name. This will build a
system that includes profiling code; see kgmon(8) and
gprof(1).
-s Equivalent to ``options SOURCE'', or if repeated, to
``options SOURCE, ALLSRC'', this can be used by source cus-
tomers to build from source using binary-only configurations.
All of the command line options are best used only for ``one-shot'' spe-
cial compilations of existing configurations. If more than one build
will use the same options, making a new configuration file containing the
proper options and makeoptions lines will avoid future errors such as
forgetting an option or misspelling the option on the command line.
The output of config consists of a number of files, principally ioconf.c,
a description of I/O devices that may be attached to the system; and a
Makefile, used by make(1) in building the kernel.
After running config, it is wise to run ``make depend'' in the directory
where the new makefile was created. Config prints a reminder of this
when it completes.
If config stops due to errors, the problems reported should be corrected
and config should be run again. Config attempts to avoid changing the
compilation directory if there are configuration errors, but some prob-
lems (such as running out of disk space) are unrecoverable.
SEE ALSO
The SYNOPSIS portion of each device in section 4.
Building Kernels on BSD/OS.
HISTORY
The config command appeared in 4.1BSD. It was completely revised in
4.4BSD.
4th Berkeley Distribution April 19, 1994 2
