Commit | Line | Data |
---|---|---|
62a2aae7 KB |
1 | .\" Copyright (c) 1980, 1991, 1993 |
2 | .\" The Regents of the University of California. All rights reserved. | |
2cb712b1 CT |
3 | .\" |
4 | .\" %sccs.include.redist.man% | |
5 | .\" | |
2c5e9438 | 6 | .\" @(#)config.8 8.2 (Berkeley) %G% |
2cb712b1 CT |
7 | .\" |
8 | .Dd | |
2c5e9438 | 9 | .Dt CONFIG.NEW 8 |
2cb712b1 CT |
10 | .Os BSD 4 |
11 | .Sh NAME | |
2c5e9438 | 12 | .Nm config.new |
2cb712b1 CT |
13 | .Nd build kernel compilation directories |
14 | .Sh SYNOPSIS | |
15 | .Nm config | |
16 | .Op Fl p | |
17 | .Ar system-name | |
18 | .Sh DESCRIPTION | |
19 | .Pp | |
2c5e9438 KM |
20 | This is the new version of the |
21 | .Nm config | |
22 | program. | |
23 | It understands the more modern autoconfiguration scheme | |
24 | used on the SPARC and i386 platforms. | |
25 | The old version of config is still used with the | |
26 | HP300, DECstation, and derivative platforms. | |
27 | Only the version of | |
28 | .Nm config | |
29 | applicable to the architecture that you are running | |
30 | will be installed on your machine. | |
31 | .Pp | |
2cb712b1 CT |
32 | .Nm Config |
33 | builds a set of configuration files from the file | |
34 | .Ar system-name , | |
35 | which describes | |
36 | the system to configure. | |
37 | .Pp | |
38 | .Nm Config | |
39 | should run from the | |
40 | .Pa conf | |
41 | subdirectory of the top-level machine-specific directory | |
42 | of the system source (usually | |
43 | .Pa /sys/MACHINE/conf , | |
44 | where | |
45 | .Pa MACHINE | |
46 | is one of | |
47 | .Pa vax , | |
48 | .Pa tahoe , | |
49 | .Pa hp300 , | |
50 | and so forth). | |
51 | .Nm Config | |
52 | assumes the directory | |
53 | .Pa ../../compile | |
54 | exists; it places all output files in a subdirectory there, | |
55 | creating the subdirectory if necessary. | |
56 | The subdirectory name is taken from the | |
57 | .Ar system-name ; | |
58 | thus, configuring with | |
59 | .Dq Li config PICKLE | |
60 | will use the directory | |
61 | .Pa ../../compile/PICKLE . | |
62 | .Pp | |
63 | If the | |
64 | .Fl p | |
65 | option is supplied, | |
66 | .Pa .PROF | |
67 | is appended to the compilation directory name, and | |
68 | .Nm config | |
69 | acts as if the lines | |
70 | .Dq Li makeoptions PROF="-pg" | |
71 | and | |
72 | .Dq Li options GPROF | |
73 | appeared in the configuration file. | |
74 | This will build a system that includes profiling code; see | |
75 | .Xr kgmon 8 | |
76 | and | |
77 | .Xr gprof 1 . | |
78 | The | |
79 | .Fl p | |
80 | flag is expected to be used for | |
81 | .Dq one-shot | |
82 | profiles of existing systems; | |
83 | for regular profiling, | |
84 | it is probably wiser to make a separate configuration | |
85 | containing the | |
86 | .Li makeoptions | |
87 | line. | |
88 | .Pp | |
89 | The old undocumented | |
90 | .Fl g | |
91 | flag is no longer supported. | |
92 | Instead, use | |
93 | .Dq Li makeoptions DEBUG="-g" | |
94 | and (typically) | |
95 | .Dq Li options KGDB . | |
96 | .Pp | |
97 | The output of | |
98 | .Nm config | |
99 | consists of a number of files, principally | |
100 | .Pa ioconf.c , | |
101 | a description of I/O devices that may be attached to the system; and a | |
102 | .Pa Makefile , | |
103 | used by | |
104 | .Xr make 1 | |
105 | in building the kernel. | |
106 | .Pp | |
107 | After running | |
108 | .Nm config , | |
109 | it is wise to run | |
110 | .Dq Li make depend | |
111 | in the directory where the new makefile | |
112 | was created. | |
113 | .Nm Config | |
114 | prints a reminder of this when it completes. | |
115 | .Pp | |
116 | If | |
117 | .Nm config | |
118 | stops due to errors, the problems reported should be corrected and | |
119 | .Nm config | |
120 | should be run again. | |
121 | .Nm Config | |
122 | attempts to avoid changing the compilation directory | |
123 | if there are configuration errors, | |
124 | but this code is not well-tested, | |
125 | and some problems (such as running out of disk space) | |
126 | are unrecoverable. | |
127 | .Sh SEE ALSO | |
128 | The SYNOPSIS portion of each device in section 4. | |
129 | .Rs | |
130 | .%T "Building 4.4 BSD Systems with Config" | |
131 | .\" .%T "Device Support in 4.4BSD" | |
132 | .Re | |
2c5e9438 KM |
133 | .sp |
134 | .Xr config 8 | |
2cb712b1 CT |
135 | .Sh HISTORY |
136 | The | |
137 | .Nm | |
138 | command appeared in | |
139 | .Bx 4.1 . | |
140 | It was completely revised in | |
141 | .Bx 4.4 . |