Commit | Line | Data |
---|---|---|
8c7df50e KM |
1 | .\" Copyright (c) 1980 Regents of the University of California. |
2 | .\" All rights reserved. The Berkeley software License Agreement | |
3 | .\" specifies the terms and conditions for redistribution. | |
4 | .\" | |
ce55c8d8 | 5 | .\" @(#)config.8 6.1 (Berkeley) %G% |
8c7df50e | 6 | .\" |
ce55c8d8 | 7 | .TH CONFIG 8 "" |
8c7df50e KM |
8 | .UC 4 |
9 | .SH NAME | |
aab530e6 | 10 | config \- build system configuration files |
8c7df50e KM |
11 | .SH SYNOPSIS |
12 | .B /etc/config | |
aab530e6 KM |
13 | [ |
14 | .B \-p | |
15 | ] | |
8c7df50e KM |
16 | .I config_file |
17 | .SH DESCRIPTION | |
18 | .PP | |
19 | .I Config | |
20 | builds a set of system configuration files from a short file which describes | |
21 | the sort of system that is being configured. It also takes as input a file | |
22 | which tells | |
23 | .I config | |
24 | what files are needed to generate a system. | |
aab530e6 KM |
25 | This can be augmented by a configuration specific set of files |
26 | that give alternate files for a specific machine. | |
27 | (see the FILES section below) | |
28 | If the | |
29 | .B \-p | |
30 | option is supplied, | |
31 | .I config | |
32 | will configure a system for profiling; c.f. | |
33 | .IR kgmon (8), | |
34 | .IR gprof (1). | |
8c7df50e KM |
35 | .PP |
36 | .I Config | |
37 | should be run from the | |
38 | .B conf | |
aab530e6 | 39 | subdirectory of the system source (usually /sys/conf). |
8c7df50e KM |
40 | .I Config |
41 | assumes that there is already a directory | |
42 | .I "../config_file" | |
43 | created and it places all its output files in there. | |
44 | The output of | |
45 | .I config | |
46 | consists of a number files: | |
47 | .B ioconf.c | |
aab530e6 KM |
48 | contains a description |
49 | of what i/o devices are attached to the system,; | |
8c7df50e | 50 | .B ubglue.s |
aab530e6 KM |
51 | contains a set of interrupt service routines for devices |
52 | attached to the UNIBUS; | |
8c7df50e | 53 | .B makefile |
aab530e6 KM |
54 | is a file used by |
55 | .IR make (1) | |
56 | in building the system; a set of header files which contain | |
57 | the number of various devices that will be compiled into the system; | |
58 | and a set of swap configuration files which contain definitions for | |
59 | the disk areas to be used for swapping, the root file system, | |
60 | argument processing, and system dumps. | |
8c7df50e KM |
61 | .PP |
62 | After running | |
aab530e6 | 63 | .IR config , |
8c7df50e KM |
64 | it is necessary to run "make depend" in the directory where the new makefile |
65 | was created. | |
66 | .I Config | |
67 | reminds you of this when it completes. | |
68 | .PP | |
69 | If you get any other error messages from | |
70 | .I config, | |
71 | you should fix the problems in your configuration file and try again. | |
aab530e6 KM |
72 | If you try to compile a system that had configuration errors, you |
73 | will likely meet with failure. | |
74 | .SH FILES | |
8c7df50e | 75 | .nf |
aab530e6 KM |
76 | /sys/conf/makefile.vax generic makefile for the VAX |
77 | /sys/conf/files list of common files system is built from | |
78 | /sys/conf/files.vax list of VAX specific files | |
79 | /sys/conf/devices.vax name to major device mapping file for the VAX | |
80 | /sys/conf/files.ERNIE list of files specific to ERNIE system | |
8c7df50e | 81 | .fi |
8c7df50e | 82 | .SH SEE ALSO |
aab530e6 KM |
83 | ``Building 4.2BSD UNIX System with Config'' |
84 | .br | |
8c7df50e | 85 | The SYNOPSIS portion of each device in section 4. |
8c7df50e KM |
86 | .SH BUGS |
87 | The line numbers reported in error messages are usually off by one. |