1.\" Copyright (c) 1980, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)config.8 8.2 (Berkeley) 04/19/94 7.\" 8.Dd 9.Dt CONFIG 8 10.Os BSD 4 11.Sh NAME 12.Nm config 13.Nd build system configuration files 14.Sh SYNOPSIS 15.Nm config 16.Op Fl p 17.Ar system_name 18.Sh DESCRIPTION 19.Pp 20This is the old version of the 21.Nm config 22program. 23It understands the old autoconfiguration scheme 24used on the HP300, DECstation, and derivative platforms. 25The new version of config is used with the 26SPARC and i386 platforms. 27Only the version of 28.Nm config 29applicable to the architecture that you are running 30will be installed on your machine. 31.Pp 32.Nm Config 33builds a set of system configuration files from the file 34.Ar SYSTEM_NAME 35which describes 36the system to configure. 37A second file 38tells 39.Nm config 40what files are needed to generate a system and 41can be augmented by configuration specific set of files 42that give alternate files for a specific machine. 43(see the 44.Sx FILES 45section below) 46.Pp 47Available option and operand: 48.Pp 49.Bl -tag -width SYSTEM_NAME 50.It Fl p 51If the 52.Fl p 53option is supplied, 54.Nm config 55will configure a system for profiling; for example, 56.Xr kgmon 8 57and 58.Xr gprof 1 . 59.It Ar SYSTEM_NAME 60specifies the name of the system configuration file 61containing device specifications, configuration options 62and other system parameters for one system configuration. 63.El 64.Pp 65.Nm Config 66should be run from the 67.Pa conf 68subdirectory of the system source (usually 69.Pa /sys/conf ) . 70.Nm Config 71assumes the directory 72.Pa ../SYSTEM_NAME 73exists and places all output files there. 74The output of 75.Nm config 76consists of a number of files; for the 77.Tn VAX , 78they are: 79.Pa ioconf.c , 80a description 81of what I/O devices are attached to the system; 82.Pa ubglue.s , 83a set of interrupt service routines for devices 84attached to the 85.Tn UNIBUS ; 86.Pa ubvec.s , 87offsets into a structure used for counting per-device interrupts; 88.Pa Makefile , 89used by 90.Xr make 1 91in building the system; 92header files, 93definitions of 94the number of various devices that will be compiled into the system; 95swap configuration files, 96definitions for 97the disk areas to be used for swapping, the root file system, 98argument processing, and system dumps. 99.Pp 100After running 101.Nm config , 102it is necessary to run 103.Dq Li make depend 104in the directory where the new makefile 105was created. 106.Nm Config 107prints a reminder of this when it completes. 108.Pp 109If any other error messages are produced by 110.Nm config , 111the problems in the configuration file should be corrected and 112.Nm config 113should be run again. 114Attempts to compile a system that had configuration errors 115are likely to fail. 116.Sh FILES 117.Bl -tag -width /sys/conf/Makefile.vax -compact 118.It Pa /sys/conf/Makefile.vax 119generic makefile for the 120.Tn VAX 121.It Pa /sys/conf/files 122list of common files system is built from 123.It Pa /sys/conf/files.vax 124list of 125.Tn VAX 126specific files 127.It Pa /sys/conf/devices.vax 128name to major device mapping file for the 129.Tn VAX 130.It Pa /sys/conf/files. Ns Em ERNIE 131list of files specific to 132.Em ERNIE 133system 134.El 135.Sh SEE ALSO 136The SYNOPSIS portion of each device in section 4. 137.Rs 138.%T "Building 4.3 BSD UNIX System with Config" 139.Re 140.sp 141.Xr config.new 8 142.Sh BUGS 143The line numbers reported in error messages are usually off by one. 144.Sh HISTORY 145The 146.Nm 147command appeared in 148.Bx 4.1 . 149