1.\" Copyright (c) 1980, 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 25 unchanged lines hidden (view full) ---

34.Dd April 19, 1994
35.Dt CONFIG 8
36.Os BSD 4
37.Sh NAME
38.Nm config
39.Nd build system configuration files
40.Sh SYNOPSIS
41.Nm config
42.Op Fl gp
43.Ar SYSTEM_NAME
44.Sh DESCRIPTION
45.Pp
46This is the old version of the
47.Nm config
48program.
49It understands the old autoconfiguration scheme
50used on the HP300, i386, DECstation, and derivative platforms.
51The new version of config is used with the
52SPARC platform.
53Only the version of
54.Nm config
55applicable to the architecture that you are running
56will be installed on your machine.
57.Pp
58.Nm Config
59builds a set of system configuration files from the file
60.Ar SYSTEM_NAME

--- 7 unchanged lines hidden (view full) ---

68that give alternate files for a specific machine.
69(see the
70.Sx FILES
71section below)
72.Pp
73Available option and operand:
74.Pp
75.Bl -tag -width SYSTEM_NAME
76.It Fl g
77If the
78.Fl g
79option is supplied,
80.Nm config
81will configure a system for debugging.
82.It Fl p
83If the
84.Fl p
85option is supplied,
86.Nm config
87will configure a system for profiling; for example,
88.Xr kgmon 8
89and
90.Xr gprof 1 .
91.It Ar SYSTEM_NAME
92specifies the name of the system configuration file
93containing device specifications, configuration options
94and other system parameters for one system configuration.
95.El
96.Pp
97.Nm Config
98should be run from the
99.Pa conf
100subdirectory of the system source (usually
101.Pa /sys/ARCH/conf ) .
102.Nm Config
103assumes the directory
104.Pa ../../compile/SYSTEM_NAME
105exists and places all output files there.
106The output of
107.Nm config
108consists of a number of files; for the
109.Tn i386 ,
110they are:
111.Pa ioconf.c ,
112a description
113of what I/O devices are attached to the system;
114.Pa vector.h ,
115a set of interrupt service routines for devices
116attached to the bus plus
117offsets into a structure used for counting per-device interrupts;
118.Pa Makefile ,
119used by
120.Xr make 1
121in building the system;
122header files,
123definitions of
124the number of various devices that will be compiled into the system;

--- 14 unchanged lines hidden (view full) ---

139If any other error messages are produced by
140.Nm config ,
141the problems in the configuration file should be corrected and
142.Nm config
143should be run again.
144Attempts to compile a system that had configuration errors
145are likely to fail.
146.Sh FILES
147.Bl -tag -width /sys/i386/conf/Makefile.i386 -compact
148.It Pa /sys/conf/files
149list of common files system is built from
150.It Pa /sys/i386/conf/Makefile.i386
151generic makefile for the
152.Tn i386
153.It Pa /sys/i386/conf/files.i386
154list of
155.Tn i386
156specific files
157.It Pa /sys/i386/conf/devices.i386
158name to major device mapping file for the
159.Tn i386
160.It Pa /sys/i386/conf/files. Ns Em ERNIE
161list of files specific to
162.Em ERNIE
163system
164.El
165.Sh SEE ALSO
166The SYNOPSIS portion of each device in section 4.
167.Rs
168.%T "Building 4.3 BSD UNIX System with Config"
169.Re
170.sp
171.Xr config.new 8
172.Sh BUGS
173The line numbers reported in error messages are usually off by one.
174.Sh HISTORY
175The
176.Nm
177command appeared in
178.Bx 4.1 .