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.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\" must display the following acknowledgement:
14.\" This product includes software developed by the University of
15.\" California, Berkeley and its contributors.
16.\" 4. Neither the name of the University nor the names of its contributors
17.\" may be used to endorse or promote products derived from this software
18.\" without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)config.8 8.2 (Berkeley) 4/19/94
33.\"
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
| 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.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\" must display the following acknowledgement:
14.\" This product includes software developed by the University of
15.\" California, Berkeley and its contributors.
16.\" 4. Neither the name of the University nor the names of its contributors
17.\" may be used to endorse or promote products derived from this software
18.\" without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)config.8 8.2 (Berkeley) 4/19/94
33.\"
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 p
43.Ar system_name
| 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
| 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, DECstation, and derivative platforms.
| 50used on the HP300, i386, DECstation, and derivative platforms.
|
51The new version of config is used with the
| 51The new version of config is used with the
|
52SPARC and i386 platforms.
| 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
61which describes
62the system to configure.
63A second file
64tells
65.Nm config
66what files are needed to generate a system and
67can be augmented by configuration specific set of files
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
| 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
61which describes
62the system to configure.
63A second file
64tells
65.Nm config
66what files are needed to generate a system and
67can be augmented by configuration specific set of files
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.
|
76.It Fl p
77If the
78.Fl p
79option is supplied,
80.Nm config
81will configure a system for profiling; for example,
82.Xr kgmon 8
83and
84.Xr gprof 1 .
85.It Ar SYSTEM_NAME
86specifies the name of the system configuration file
87containing device specifications, configuration options
88and other system parameters for one system configuration.
89.El
90.Pp
91.Nm Config
92should be run from the
93.Pa conf
94subdirectory of the system source (usually
| 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
|
95.Pa /sys/conf ) .
| 101.Pa /sys/ARCH/conf ) .
|
96.Nm Config
97assumes the directory
| 102.Nm Config
103assumes the directory
|
98.Pa ../SYSTEM_NAME
| 104.Pa ../../compile/SYSTEM_NAME
|
99exists and places all output files there.
100The output of
101.Nm config
102consists of a number of files; for the
| 105exists and places all output files there.
106The output of
107.Nm config
108consists of a number of files; for the
|
103.Tn VAX ,
| 109.Tn i386 ,
|
104they are:
105.Pa ioconf.c ,
106a description
107of what I/O devices are attached to the system;
| 110they are:
111.Pa ioconf.c ,
112a description
113of what I/O devices are attached to the system;
|
108.Pa ubglue.s ,
| 114.Pa vector.h ,
|
109a set of interrupt service routines for devices
| 115a set of interrupt service routines for devices
|
110attached to the
111.Tn UNIBUS ;
112.Pa ubvec.s ,
| 116attached to the bus plus
|
113offsets into a structure used for counting per-device interrupts;
114.Pa Makefile ,
115used by
116.Xr make 1
117in building the system;
118header files,
119definitions of
120the number of various devices that will be compiled into the system;
121swap configuration files,
122definitions for
123the disk areas to be used for swapping, the root file system,
124argument processing, and system dumps.
125.Pp
126After running
127.Nm config ,
128it is necessary to run
129.Dq Li make depend
130in the directory where the new makefile
131was created.
132.Nm Config
133prints a reminder of this when it completes.
134.Pp
135If any other error messages are produced by
136.Nm config ,
137the problems in the configuration file should be corrected and
138.Nm config
139should be run again.
140Attempts to compile a system that had configuration errors
141are likely to fail.
142.Sh FILES
| 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;
125swap configuration files,
126definitions for
127the disk areas to be used for swapping, the root file system,
128argument processing, and system dumps.
129.Pp
130After running
131.Nm config ,
132it is necessary to run
133.Dq Li make depend
134in the directory where the new makefile
135was created.
136.Nm Config
137prints a reminder of this when it completes.
138.Pp
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
|
143.Bl -tag -width /sys/conf/Makefile.vax -compact
144.It Pa /sys/conf/Makefile.vax
145generic makefile for the
146.Tn VAX
| 147.Bl -tag -width /sys/i386/conf/Makefile.i386 -compact
|
147.It Pa /sys/conf/files
148list of common files system is built from
| 148.It Pa /sys/conf/files
149list of common files system is built from
|
149.It Pa /sys/conf/files.vax
| 150.It Pa /sys/i386/conf/Makefile.i386
151generic makefile for the
152.Tn i386
153.It Pa /sys/i386/conf/files.i386
|
150list of
| 154list of
|
151.Tn VAX
| 155.Tn i386
|
152specific files
| 156specific files
|
153.It Pa /sys/conf/devices.vax
| 157.It Pa /sys/i386/conf/devices.i386
|
154name to major device mapping file for the
| 158name to major device mapping file for the
|
155.Tn VAX
156.It Pa /sys/conf/files. Ns Em ERNIE
| 159.Tn i386
160.It Pa /sys/i386/conf/files. Ns Em ERNIE
|
157list of files specific to
158.Em ERNIE
159system
160.El
161.Sh SEE ALSO
162The SYNOPSIS portion of each device in section 4.
163.Rs
164.%T "Building 4.3 BSD UNIX System with Config"
165.Re
166.sp
167.Xr config.new 8
168.Sh BUGS
169The line numbers reported in error messages are usually off by one.
170.Sh HISTORY
171The
172.Nm
173command appeared in
174.Bx 4.1 .
| 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 .
|