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