Clean up deleted files.
This commit is contained in:
mycroft
parent
0f874c8bdd
commit
ce9288836b
|
|
@ -1,153 +0,0 @@
|
|||
.\" Copyright (c) 1980, 1991 The Regents of the University of California.
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistributions of source code must retain the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer.
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in the
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\" 3. All advertising materials mentioning features or use of this software
|
||||
.\" must display the following acknowledgement:
|
||||
.\" This product includes software developed by the University of
|
||||
.\" California, Berkeley and its contributors.
|
||||
.\" 4. Neither the name of the University nor the names of its contributors
|
||||
.\" may be used to endorse or promote products derived from this software
|
||||
.\" without specific prior written permission.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||||
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" @(#)config.8 5.1 (Berkeley) 1/12/93
|
||||
.\"
|
||||
.Dd January 12, 1993
|
||||
.Dt CONFIG 8
|
||||
.Os BSD 4
|
||||
.Sh NAME
|
||||
.Nm config
|
||||
.Nd build kernel compilation directories
|
||||
.Sh SYNOPSIS
|
||||
.Nm config
|
||||
.Op Fl p
|
||||
.Ar system-name
|
||||
.Sh DESCRIPTION
|
||||
.Pp
|
||||
.Nm Config
|
||||
builds a set of configuration files from the file
|
||||
.Ar system-name ,
|
||||
which describes
|
||||
the system to configure.
|
||||
.Pp
|
||||
.Nm Config
|
||||
should run from the
|
||||
.Pa conf
|
||||
subdirectory of the top-level machine-specific directory
|
||||
of the system source (usually
|
||||
.Pa /sys/MACHINE/conf ,
|
||||
where
|
||||
.Pa MACHINE
|
||||
is one of
|
||||
.Pa vax ,
|
||||
.Pa tahoe ,
|
||||
.Pa hp300 ,
|
||||
and so forth).
|
||||
.Nm Config
|
||||
assumes the directory
|
||||
.Pa ../../compile
|
||||
exists; it places all output files in a subdirectory there,
|
||||
creating the subdirectory if necessary.
|
||||
The subdirectory name is taken from the
|
||||
.Ar system-name ;
|
||||
thus, configuring with
|
||||
.Dq Li config PICKLE
|
||||
will use the directory
|
||||
.Pa ../../compile/PICKLE .
|
||||
.Pp
|
||||
If the
|
||||
.Fl p
|
||||
option is supplied,
|
||||
.Pa .PROF
|
||||
is appended to the compilation directory name, and
|
||||
.Nm config
|
||||
acts as if the lines
|
||||
.Dq Li makeoptions PROF="-pg"
|
||||
and
|
||||
.Dq Li options GPROF
|
||||
appeared in the configuration file.
|
||||
This will build a system that includes profiling code; see
|
||||
.Xr kgmon 8
|
||||
and
|
||||
.Xr gprof 1 .
|
||||
The
|
||||
.Fl p
|
||||
flag is expected to be used for
|
||||
.Dq one-shot
|
||||
profiles of existing systems;
|
||||
for regular profiling,
|
||||
it is probably wiser to make a separate configuration
|
||||
containing the
|
||||
.Li makeoptions
|
||||
line.
|
||||
.Pp
|
||||
The old undocumented
|
||||
.Fl g
|
||||
flag is no longer supported.
|
||||
Instead, use
|
||||
.Dq Li makeoptions DEBUG="-g"
|
||||
and (typically)
|
||||
.Dq Li options KGDB .
|
||||
.Pp
|
||||
The output of
|
||||
.Nm config
|
||||
consists of a number of files, principally
|
||||
.Pa ioconf.c ,
|
||||
a description of I/O devices that may be attached to the system; and a
|
||||
.Pa Makefile ,
|
||||
used by
|
||||
.Xr make 1
|
||||
in building the kernel.
|
||||
.Pp
|
||||
After running
|
||||
.Nm config ,
|
||||
it is wise to run
|
||||
.Dq Li make depend
|
||||
in the directory where the new makefile
|
||||
was created.
|
||||
.Nm Config
|
||||
prints a reminder of this when it completes.
|
||||
.Pp
|
||||
If
|
||||
.Nm config
|
||||
stops due to errors, the problems reported should be corrected and
|
||||
.Nm config
|
||||
should be run again.
|
||||
.Nm Config
|
||||
attempts to avoid changing the compilation directory
|
||||
if there are configuration errors,
|
||||
but this code is not well-tested,
|
||||
and some problems (such as running out of disk space)
|
||||
are unrecoverable.
|
||||
.Sh SEE ALSO
|
||||
The SYNOPSIS portion of each device in section 4.
|
||||
.Rs
|
||||
.%T "Building 4.4 BSD Systems with Config"
|
||||
.\" .%T "Device Support in 4.4BSD"
|
||||
.Re
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Nm
|
||||
command appeared in
|
||||
.Bx 4.1 .
|
||||
It was completely revised in
|
||||
.Bx 4.4 .
|
||||
Loading…
Reference in New Issue