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