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 | .\" | |
9f2dd52f | 5 | .\" @(#)config.8 6.2 (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 | ] | |
9f2dd52f | 16 | .I SYSTEM_NAME |
8c7df50e KM |
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. | |
9f2dd52f MK |
33 | .IR kgmon (8) |
34 | and | |
aab530e6 | 35 | .IR gprof (1). |
8c7df50e KM |
36 | .PP |
37 | .I Config | |
38 | should be run from the | |
39 | .B conf | |
aab530e6 | 40 | subdirectory of the system source (usually /sys/conf). |
9f2dd52f MK |
41 | Its argument is the name of a system configuration file |
42 | containing device specifications, configuration options | |
43 | and other system parameters for one system configuration. | |
8c7df50e KM |
44 | .I Config |
45 | assumes that there is already a directory | |
9f2dd52f | 46 | .I "../SYSTEM_NAME" |
8c7df50e KM |
47 | created and it places all its output files in there. |
48 | The output of | |
49 | .I config | |
9f2dd52f | 50 | consists of a number of files; for the VAX, they are: |
8c7df50e | 51 | .B ioconf.c |
aab530e6 | 52 | contains a description |
9f2dd52f | 53 | of what I/O devices are attached to the system,; |
8c7df50e | 54 | .B ubglue.s |
aab530e6 KM |
55 | contains a set of interrupt service routines for devices |
56 | attached to the UNIBUS; | |
9f2dd52f MK |
57 | .B ubvec.s |
58 | contains offsets into a structure used for counting per-device interrupts; | |
59 | .B Makefile | |
aab530e6 KM |
60 | is a file used by |
61 | .IR make (1) | |
9f2dd52f | 62 | in building the system; a set of header files contain definitions of |
aab530e6 | 63 | the number of various devices that will be compiled into the system; |
9f2dd52f | 64 | and a set of swap configuration files contain definitions for |
aab530e6 KM |
65 | the disk areas to be used for swapping, the root file system, |
66 | argument processing, and system dumps. | |
8c7df50e KM |
67 | .PP |
68 | After running | |
aab530e6 | 69 | .IR config , |
9f2dd52f | 70 | it is necessary to run ``make depend'' in the directory where the new makefile |
8c7df50e KM |
71 | was created. |
72 | .I Config | |
9f2dd52f | 73 | prints a reminder of this when it completes. |
8c7df50e | 74 | .PP |
9f2dd52f | 75 | If any other error messages are produced by |
8c7df50e | 76 | .I config, |
9f2dd52f MK |
77 | the problems in the configuration file should be corrected and |
78 | .I config | |
79 | should be run again. | |
80 | Attempts to compile a system that had configuration errors | |
81 | are likely to meet with failure. | |
aab530e6 | 82 | .SH FILES |
8c7df50e | 83 | .nf |
9f2dd52f | 84 | /sys/conf/Makefile.vax generic makefile for the VAX |
aab530e6 KM |
85 | /sys/conf/files list of common files system is built from |
86 | /sys/conf/files.vax list of VAX specific files | |
87 | /sys/conf/devices.vax name to major device mapping file for the VAX | |
88 | /sys/conf/files.ERNIE list of files specific to ERNIE system | |
8c7df50e | 89 | .fi |
8c7df50e | 90 | .SH SEE ALSO |
9f2dd52f | 91 | ``Building 4.3BSD UNIX System with Config'' |
aab530e6 | 92 | .br |
8c7df50e | 93 | The SYNOPSIS portion of each device in section 4. |
8c7df50e KM |
94 | .SH BUGS |
95 | The line numbers reported in error messages are usually off by one. |