The Regents of the University of California. All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software
must display the following acknowledgement:
This product includes software developed by the University of
California, Berkeley and its contributors.
4. Neither the name of the University nor the names of its contributors
may be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
@(#)config.8 8.2 (Berkeley) 4/19/94
.Dd April 19, 1994 .Dt CONFIG 8 .Os BSD 4 .Sh NAME .Nm config .Nd build system configuration files .Sh SYNOPSIS .Nm config .Op Fl p .Ar system_name .Sh DESCRIPTION
p This is the old version of the .Nm config program. It understands the old autoconfiguration scheme used on the HP300, DECstation, and derivative platforms. The new version of config is used with the SPARC and i386 platforms. Only the version of .Nm config applicable to the architecture that you are running will be installed on your machine.
p .Nm Config builds a set of system configuration files from the file .Ar SYSTEM_NAME which describes the system to configure. A second file tells .Nm config what files are needed to generate a system and can be augmented by configuration specific set of files that give alternate files for a specific machine. (see the .Sx FILES section below)
p Available option and operand:
p l -tag -width SYSTEM_NAME t Fl p If the .Fl p option is supplied, .Nm config will configure a system for profiling; for example, .Xr kgmon 8 and .Xr gprof 1 . t Ar SYSTEM_NAME specifies the name of the system configuration file containing device specifications, configuration options and other system parameters for one system configuration. .El
p .Nm Config should be run from the
a conf subdirectory of the system source (usually
a /sys/conf ) . .Nm Config assumes the directory
a ../SYSTEM_NAME exists and places all output files there. The output of .Nm config consists of a number of files; for the .Tn VAX , they are:
a ioconf.c , a description of what I/O devices are attached to the system;
a ubglue.s , a set of interrupt service routines for devices attached to the .Tn UNIBUS ;
a ubvec.s , offsets into a structure used for counting per-device interrupts;
a Makefile , used by .Xr make 1 in building the system; header files, definitions of the number of various devices that will be compiled into the system; swap configuration files, definitions for the disk areas to be used for swapping, the root file system, argument processing, and system dumps.
p After running .Nm config , it is necessary to run .Dq Li make depend in the directory where the new makefile was created. .Nm Config prints a reminder of this when it completes.
p If any other error messages are produced by .Nm config , the problems in the configuration file should be corrected and .Nm config should be run again. Attempts to compile a system that had configuration errors are likely to fail. .Sh FILES l -tag -width /sys/conf/Makefile.vax -compact t Pa /sys/conf/Makefile.vax generic makefile for the .Tn VAX t Pa /sys/conf/files list of common files system is built from t Pa /sys/conf/files.vax list of .Tn VAX specific files t Pa /sys/conf/devices.vax name to major device mapping file for the .Tn VAX t Pa /sys/conf/files. Ns Em ERNIE list of files specific to .Em ERNIE system .El .Sh SEE ALSO The SYNOPSIS portion of each device in section 4. .Rs .%T "Building 4.3 BSD UNIX System with Config" .Re .Xr config.new 8 .Sh BUGS The line numbers reported in error messages are usually off by one. .Sh HISTORY The .Nm command appeared in x 4.1 .