config.8 (163590) | config.8 (169507) |
---|---|
1.\" Copyright (c) 1980, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 12 unchanged lines hidden (view full) --- 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.\" @(#)config.8 8.2 (Berkeley) 4/19/94 | 1.\" Copyright (c) 1980, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 12 unchanged lines hidden (view full) --- 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.\" @(#)config.8 8.2 (Berkeley) 4/19/94 |
29.\" $FreeBSD: head/usr.sbin/config/config.8 163590 2006-10-21 20:09:51Z ru $ | 29.\" $FreeBSD: head/usr.sbin/config/config.8 169507 2007-05-12 19:38:18Z wkoszek $ |
30.\" | 30.\" |
31.Dd December 16, 2004 | 31.Dd May 8, 2007 |
32.Dt CONFIG 8 33.Os 34.Sh NAME 35.Nm config 36.Nd build system configuration files 37.Sh SYNOPSIS 38.Nm | 32.Dt CONFIG 8 33.Os 34.Sh NAME 35.Nm config 36.Nd build system configuration files 37.Sh SYNOPSIS 38.Nm |
39.Op Fl Vgp | 39.Op Fl CVgp |
40.Op Fl d Ar destdir 41.Ar SYSTEM_NAME | 40.Op Fl d Ar destdir 41.Ar SYSTEM_NAME |
42.Nm 43.Op Fl x Ar kernel |
|
42.Sh DESCRIPTION 43.\" This is the old version of the 44.\" .Nm 45.\" utility. 46.\" It understands the old autoconfiguration scheme 47.\" used on the HP300, i386, DECstation, and derivative platforms. 48.\" The new version of 49.\" .Nm --- 21 unchanged lines hidden (view full) --- 71section below). 72.Pp 73Available options and operands: 74.Bl -tag -width ".Ar SYSTEM_NAME" 75.It Fl V 76Print the 77.Nm 78version number. | 44.Sh DESCRIPTION 45.\" This is the old version of the 46.\" .Nm 47.\" utility. 48.\" It understands the old autoconfiguration scheme 49.\" used on the HP300, i386, DECstation, and derivative platforms. 50.\" The new version of 51.\" .Nm --- 21 unchanged lines hidden (view full) --- 73section below). 74.Pp 75Available options and operands: 76.Bl -tag -width ".Ar SYSTEM_NAME" 77.It Fl V 78Print the 79.Nm 80version number. |
81.It Fl C 82If the INCLUDE_CONFIG_FILE is present in a configuration file, 83kernel image will contain full configuration files included 84literally (preserving comments). 85This flag is kept for backward compatibility. |
|
79.It Fl d Ar destdir 80Use 81.Ar destdir 82as the output directory, instead of the default one. 83Note that 84.Nm 85does not append 86.Ar SYSTEM_NAME 87to the directory given. 88.It Fl g 89Configure a system for debugging. | 86.It Fl d Ar destdir 87Use 88.Ar destdir 89as the output directory, instead of the default one. 90Note that 91.Nm 92does not append 93.Ar SYSTEM_NAME 94to the directory given. 95.It Fl g 96Configure a system for debugging. |
97.It Fl x Ar kernel 98Print kernel configuration file embedded into a kernel 99file. 100This option makes sense only if 101.Cd "options INCLUDE_CONFIG_FILE" 102entry was present in your configuration file. |
|
90.It Fl p 91Configure a system for profiling; for example, 92.Xr kgmon 8 93and 94.Xr gprof 1 . 95If two or more 96.Fl p 97options are supplied, --- 48 unchanged lines hidden (view full) --- 146.Pp 147If any other error messages are produced by 148.Nm , 149the problems in the configuration file should be corrected and 150.Nm 151should be run again. 152Attempts to compile a system that had configuration errors 153are likely to fail. | 103.It Fl p 104Configure a system for profiling; for example, 105.Xr kgmon 8 106and 107.Xr gprof 1 . 108If two or more 109.Fl p 110options are supplied, --- 48 unchanged lines hidden (view full) --- 159.Pp 160If any other error messages are produced by 161.Nm , 162the problems in the configuration file should be corrected and 163.Nm 164should be run again. 165Attempts to compile a system that had configuration errors 166are likely to fail. |
154.Pp 155If the 156.Cd "options INCLUDE_CONFIG_FILE" 157is used in the configuration file the 158entire input file is embedded in the new kernel. 159This means that 160.Xr strings 1 161can be used to extract it from a kernel: 162to extract the configuration information, use the command 163.Pp 164.Dl "strings -n 3 kernel | sed -n 's/^___//p'" | |
165.Sh DEBUG KERNELS 166Traditional 167.Bx 168kernels are compiled without symbols due to the heavy load on the 169system when compiling a 170.Dq debug 171kernel. 172A debug kernel contains complete symbols for all the source files, and --- 76 unchanged lines hidden (view full) --- 249.Rs 250.%T "Building 4.3 BSD UNIX System with Config" 251.Re 252.Sh HISTORY 253The 254.Nm 255utility appeared in 256.Bx 4.1 . | 167.Sh DEBUG KERNELS 168Traditional 169.Bx 170kernels are compiled without symbols due to the heavy load on the 171system when compiling a 172.Dq debug 173kernel. 174A debug kernel contains complete symbols for all the source files, and --- 76 unchanged lines hidden (view full) --- 251.Rs 252.%T "Building 4.3 BSD UNIX System with Config" 253.Re 254.Sh HISTORY 255The 256.Nm 257utility appeared in 258.Bx 4.1 . |
259.Pp 260Before support for 261.Fl x 262was introduced, 263.Cd "options INCLUDE_CONFIG_FILE" 264included entire configuration file that used to be embedded in 265the new kernel. 266This meant that 267.Xr strings 1 268could be used to extract it from a kernel: 269to extract the configuration information, you had to use 270the command: 271.Pp 272.Dl "strings -n 3 kernel | sed -n 's/^___//p'" |
|
257.Sh BUGS 258The line numbers reported in error messages are usually off by one. | 273.Sh BUGS 274The line numbers reported in error messages are usually off by one. |