1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
|
.\" -*- nroff -*-
.\" Copyright (c) 1991, 1992, 1996 Cygnus Support
.\" written by K. Richard Pixley
.TH configure 1 "29 March 1996" "cygnus support" "Cygnus Support"
.de BP
.sp
.ti \-.2i
\(**
..
.SH NAME
configure \- prepare source code to be built
.SH SYNOPSIS
configure HOST [--target=TARGET] [--srcdir=DIR] [--rm]
[--site=SITE] [--prefix=DIR] [--exec_prefix=DIR]
[--program_prefix=DIR] [--tmpdir=DIR]
[--with-PACKAGE[=YES/NO]] [--without-PACKAGE]
[--enable-FEATURE[=YES/NO]] [--disable-FEATURE]
[--norecursion] [--nfp] [-s] [-v] [-V | --version] [--help]
.SH DESCRIPTION
.I configure
is a program used to prepare souce code to be built. It does this by
generating Makefiles and .gdbinit files, creating symlinks, recursing
in subdirectories, and some other miscellaneous file editing.
.SH OPTIONS
.I configure
accepts the following options:
.TP
.I \--target=TARGET
Requests that the sources be configured to target the
.I TARGET
machine. If no target is specified explicitly, the target is assumed
to be the same as the host.
.TP
.I \--srcdir=DIR
tells configure to find the source in
.I DIR.
Object code is always built in the current directory,
.I `.'.
.TP
.I \--rm
asks configure to remove a configuration rather than create one.
.TP
.I \--site=SITE
asks configure to use any site-specific Makefile fragments for
.I SITE
when building Makefiles.
.TP
.I \--prefix=DIR
sets the location in which to install files to
.I DIR.
The default is "/usr/local".
.TP
.I \--exec_prefix=DIR
sets the root directory for host-dependent files to
.I DIR.
The default location is the value of
.I prefix.
.TP
.I \--program_prefix=DIR
configures the source to install programs which have the same names as
common Unix programs, such as "make", in
.I DIR.
Also applies to programs which might be used for cross-compilation.
.TP
.I \--tmpdir=DIR
sets the directory in which configure creates temporary files to
.I DIR.
.TP
.I \--with-PACKAGE[=YES/NO]
sets a flag for the build to recognize that
.I PACKAGE
is explicitly present or not present. If
.I \=YES/NO
is nonexistent, the default is
.I YES.
.I \--without-PACKAGE
is equivalent to
.IR \--with-PACKAGE=no .
.TP
.I \--enable-FEATURE[=YES/NO]
sets a flag for the build to recognize that
.I FEATURE
should be included or not included. If
.I \=YES/NO
is nonexistent, the default is
.I YES.
.I \--disable-FEATURE
is equivalent to
.IR --enable-FEATURE=no .
.TP
.I \--norecursion
asks that only the current directory be configured. Normally
.I configure
recurs on subdirectories.
.TP
.I \-nfp
Notifies
.I configure
that all of the specified hosts have
.I no floating point
units.
.TP
.I \-s
used internally by configure to supress status messages on
subdirectory recursions. Override with
.I \-v
.TP
.I \-v
verbose output. Asks that configure print status lines for each
directory configured. Normally, only the status lines for the current
directory are printed.
.TP
.I \--version
.I \-V
prints
.I configure
version number.
.TP
.I \-help
displays a brief usage summary.
.SH FILES
configure.in for each directory's individual needs
.br
Makefile.in Makefile template
.br
config.sub for parsing configuration names
.br
config.guess for guessing HOST when not specified
.br
config.status non-recursively rebuilds current directory
.SH FILES
.ta \w'gmon.sum 'u
a.out the namelist and text space.
.br
gmon.out dynamic call graph and profile.
.br
gmon.sum summarized dynamic call graph and profile.
.SH "SEE ALSO"
.RB "`\|" configure "\|'"
entry in
.B
info.
|
