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