xref: /aosp_15_r20/external/strace/INSTALL (revision cf84ac9a129d8ea9952db616b4e9b904c4bdde56)
1*cf84ac9aSAndroid Build Coastguard WorkerInstallation Instructions
2*cf84ac9aSAndroid Build Coastguard Worker*************************
3*cf84ac9aSAndroid Build Coastguard Worker
4*cf84ac9aSAndroid Build Coastguard WorkerCopyright (C) 1994-1996, 1999-2002, 2004-2013 Free Software Foundation,
5*cf84ac9aSAndroid Build Coastguard WorkerInc.
6*cf84ac9aSAndroid Build Coastguard Worker
7*cf84ac9aSAndroid Build Coastguard Worker   Copying and distribution of this file, with or without modification,
8*cf84ac9aSAndroid Build Coastguard Workerare permitted in any medium without royalty provided the copyright
9*cf84ac9aSAndroid Build Coastguard Workernotice and this notice are preserved.  This file is offered as-is,
10*cf84ac9aSAndroid Build Coastguard Workerwithout warranty of any kind.
11*cf84ac9aSAndroid Build Coastguard Worker
12*cf84ac9aSAndroid Build Coastguard WorkerBasic Installation
13*cf84ac9aSAndroid Build Coastguard Worker==================
14*cf84ac9aSAndroid Build Coastguard Worker
15*cf84ac9aSAndroid Build Coastguard WorkerBriefly, the shell command './configure && make && make install' should
16*cf84ac9aSAndroid Build Coastguard Workerconfigure, build, and install this package.  The following more-detailed
17*cf84ac9aSAndroid Build Coastguard Workerinstructions are generic; see the 'README' file for instructions
18*cf84ac9aSAndroid Build Coastguard Workerspecific to this package.  Some packages provide this 'INSTALL' file but
19*cf84ac9aSAndroid Build Coastguard Workerdo not implement all of the features documented below.  The lack of an
20*cf84ac9aSAndroid Build Coastguard Workeroptional feature in a given package is not necessarily a bug.  More
21*cf84ac9aSAndroid Build Coastguard Workerrecommendations for GNU packages can be found in *note Makefile
22*cf84ac9aSAndroid Build Coastguard WorkerConventions: (standards)Makefile Conventions.
23*cf84ac9aSAndroid Build Coastguard Worker
24*cf84ac9aSAndroid Build Coastguard Worker   The 'configure' shell script attempts to guess correct values for
25*cf84ac9aSAndroid Build Coastguard Workervarious system-dependent variables used during compilation.  It uses
26*cf84ac9aSAndroid Build Coastguard Workerthose values to create a 'Makefile' in each directory of the package.
27*cf84ac9aSAndroid Build Coastguard WorkerIt may also create one or more '.h' files containing system-dependent
28*cf84ac9aSAndroid Build Coastguard Workerdefinitions.  Finally, it creates a shell script 'config.status' that
29*cf84ac9aSAndroid Build Coastguard Workeryou can run in the future to recreate the current configuration, and a
30*cf84ac9aSAndroid Build Coastguard Workerfile 'config.log' containing compiler output (useful mainly for
31*cf84ac9aSAndroid Build Coastguard Workerdebugging 'configure').
32*cf84ac9aSAndroid Build Coastguard Worker
33*cf84ac9aSAndroid Build Coastguard Worker   It can also use an optional file (typically called 'config.cache' and
34*cf84ac9aSAndroid Build Coastguard Workerenabled with '--cache-file=config.cache' or simply '-C') that saves the
35*cf84ac9aSAndroid Build Coastguard Workerresults of its tests to speed up reconfiguring.  Caching is disabled by
36*cf84ac9aSAndroid Build Coastguard Workerdefault to prevent problems with accidental use of stale cache files.
37*cf84ac9aSAndroid Build Coastguard Worker
38*cf84ac9aSAndroid Build Coastguard Worker   If you need to do unusual things to compile the package, please try
39*cf84ac9aSAndroid Build Coastguard Workerto figure out how 'configure' could check whether to do them, and mail
40*cf84ac9aSAndroid Build Coastguard Workerdiffs or instructions to the address given in the 'README' so they can
41*cf84ac9aSAndroid Build Coastguard Workerbe considered for the next release.  If you are using the cache, and at
42*cf84ac9aSAndroid Build Coastguard Workersome point 'config.cache' contains results you don't want to keep, you
43*cf84ac9aSAndroid Build Coastguard Workermay remove or edit it.
44*cf84ac9aSAndroid Build Coastguard Worker
45*cf84ac9aSAndroid Build Coastguard Worker   The file 'configure.ac' (or 'configure.in') is used to create
46*cf84ac9aSAndroid Build Coastguard Worker'configure' by a program called 'autoconf'.  You need 'configure.ac' if
47*cf84ac9aSAndroid Build Coastguard Workeryou want to change it or regenerate 'configure' using a newer version of
48*cf84ac9aSAndroid Build Coastguard Worker'autoconf'.
49*cf84ac9aSAndroid Build Coastguard Worker
50*cf84ac9aSAndroid Build Coastguard Worker   The simplest way to compile this package is:
51*cf84ac9aSAndroid Build Coastguard Worker
52*cf84ac9aSAndroid Build Coastguard Worker  1. 'cd' to the directory containing the package's source code and type
53*cf84ac9aSAndroid Build Coastguard Worker     './configure' to configure the package for your system.
54*cf84ac9aSAndroid Build Coastguard Worker
55*cf84ac9aSAndroid Build Coastguard Worker     Running 'configure' might take a while.  While running, it prints
56*cf84ac9aSAndroid Build Coastguard Worker     some messages telling which features it is checking for.
57*cf84ac9aSAndroid Build Coastguard Worker
58*cf84ac9aSAndroid Build Coastguard Worker  2. Type 'make' to compile the package.
59*cf84ac9aSAndroid Build Coastguard Worker
60*cf84ac9aSAndroid Build Coastguard Worker  3. Optionally, type 'make check' to run any self-tests that come with
61*cf84ac9aSAndroid Build Coastguard Worker     the package, generally using the just-built uninstalled binaries.
62*cf84ac9aSAndroid Build Coastguard Worker
63*cf84ac9aSAndroid Build Coastguard Worker  4. Type 'make install' to install the programs and any data files and
64*cf84ac9aSAndroid Build Coastguard Worker     documentation.  When installing into a prefix owned by root, it is
65*cf84ac9aSAndroid Build Coastguard Worker     recommended that the package be configured and built as a regular
66*cf84ac9aSAndroid Build Coastguard Worker     user, and only the 'make install' phase executed with root
67*cf84ac9aSAndroid Build Coastguard Worker     privileges.
68*cf84ac9aSAndroid Build Coastguard Worker
69*cf84ac9aSAndroid Build Coastguard Worker  5. Optionally, type 'make installcheck' to repeat any self-tests, but
70*cf84ac9aSAndroid Build Coastguard Worker     this time using the binaries in their final installed location.
71*cf84ac9aSAndroid Build Coastguard Worker     This target does not install anything.  Running this target as a
72*cf84ac9aSAndroid Build Coastguard Worker     regular user, particularly if the prior 'make install' required
73*cf84ac9aSAndroid Build Coastguard Worker     root privileges, verifies that the installation completed
74*cf84ac9aSAndroid Build Coastguard Worker     correctly.
75*cf84ac9aSAndroid Build Coastguard Worker
76*cf84ac9aSAndroid Build Coastguard Worker  6. You can remove the program binaries and object files from the
77*cf84ac9aSAndroid Build Coastguard Worker     source code directory by typing 'make clean'.  To also remove the
78*cf84ac9aSAndroid Build Coastguard Worker     files that 'configure' created (so you can compile the package for
79*cf84ac9aSAndroid Build Coastguard Worker     a different kind of computer), type 'make distclean'.  There is
80*cf84ac9aSAndroid Build Coastguard Worker     also a 'make maintainer-clean' target, but that is intended mainly
81*cf84ac9aSAndroid Build Coastguard Worker     for the package's developers.  If you use it, you may have to get
82*cf84ac9aSAndroid Build Coastguard Worker     all sorts of other programs in order to regenerate files that came
83*cf84ac9aSAndroid Build Coastguard Worker     with the distribution.
84*cf84ac9aSAndroid Build Coastguard Worker
85*cf84ac9aSAndroid Build Coastguard Worker  7. Often, you can also type 'make uninstall' to remove the installed
86*cf84ac9aSAndroid Build Coastguard Worker     files again.  In practice, not all packages have tested that
87*cf84ac9aSAndroid Build Coastguard Worker     uninstallation works correctly, even though it is required by the
88*cf84ac9aSAndroid Build Coastguard Worker     GNU Coding Standards.
89*cf84ac9aSAndroid Build Coastguard Worker
90*cf84ac9aSAndroid Build Coastguard Worker  8. Some packages, particularly those that use Automake, provide 'make
91*cf84ac9aSAndroid Build Coastguard Worker     distcheck', which can by used by developers to test that all other
92*cf84ac9aSAndroid Build Coastguard Worker     targets like 'make install' and 'make uninstall' work correctly.
93*cf84ac9aSAndroid Build Coastguard Worker     This target is generally not run by end users.
94*cf84ac9aSAndroid Build Coastguard Worker
95*cf84ac9aSAndroid Build Coastguard WorkerCompilers and Options
96*cf84ac9aSAndroid Build Coastguard Worker=====================
97*cf84ac9aSAndroid Build Coastguard Worker
98*cf84ac9aSAndroid Build Coastguard WorkerSome systems require unusual options for compilation or linking that the
99*cf84ac9aSAndroid Build Coastguard Worker'configure' script does not know about.  Run './configure --help' for
100*cf84ac9aSAndroid Build Coastguard Workerdetails on some of the pertinent environment variables.
101*cf84ac9aSAndroid Build Coastguard Worker
102*cf84ac9aSAndroid Build Coastguard Worker   You can give 'configure' initial values for configuration parameters
103*cf84ac9aSAndroid Build Coastguard Workerby setting variables in the command line or in the environment.  Here is
104*cf84ac9aSAndroid Build Coastguard Workeran example:
105*cf84ac9aSAndroid Build Coastguard Worker
106*cf84ac9aSAndroid Build Coastguard Worker     ./configure CC=c99 CFLAGS=-g LIBS=-lposix
107*cf84ac9aSAndroid Build Coastguard Worker
108*cf84ac9aSAndroid Build Coastguard Worker   *Note Defining Variables::, for more details.
109*cf84ac9aSAndroid Build Coastguard Worker
110*cf84ac9aSAndroid Build Coastguard WorkerInstallation Names
111*cf84ac9aSAndroid Build Coastguard Worker==================
112*cf84ac9aSAndroid Build Coastguard Worker
113*cf84ac9aSAndroid Build Coastguard WorkerBy default, 'make install' installs the package's commands under
114*cf84ac9aSAndroid Build Coastguard Worker'/usr/local/bin', include files under '/usr/local/include', etc.  You
115*cf84ac9aSAndroid Build Coastguard Workercan specify an installation prefix other than '/usr/local' by giving
116*cf84ac9aSAndroid Build Coastguard Worker'configure' the option '--prefix=PREFIX', where PREFIX must be an
117*cf84ac9aSAndroid Build Coastguard Workerabsolute file name.
118*cf84ac9aSAndroid Build Coastguard Worker
119*cf84ac9aSAndroid Build Coastguard Worker   You can specify separate installation prefixes for
120*cf84ac9aSAndroid Build Coastguard Workerarchitecture-specific files and architecture-independent files.  If you
121*cf84ac9aSAndroid Build Coastguard Workerpass the option '--exec-prefix=PREFIX' to 'configure', the package uses
122*cf84ac9aSAndroid Build Coastguard WorkerPREFIX as the prefix for installing programs and libraries.
123*cf84ac9aSAndroid Build Coastguard WorkerDocumentation and other data files still use the regular prefix.
124*cf84ac9aSAndroid Build Coastguard Worker
125*cf84ac9aSAndroid Build Coastguard Worker   In addition, if you use an unusual directory layout you can give
126*cf84ac9aSAndroid Build Coastguard Workeroptions like '--bindir=DIR' to specify different values for particular
127*cf84ac9aSAndroid Build Coastguard Workerkinds of files.  Run 'configure --help' for a list of the directories
128*cf84ac9aSAndroid Build Coastguard Workeryou can set and what kinds of files go in them.  In general, the default
129*cf84ac9aSAndroid Build Coastguard Workerfor these options is expressed in terms of '${prefix}', so that
130*cf84ac9aSAndroid Build Coastguard Workerspecifying just '--prefix' will affect all of the other directory
131*cf84ac9aSAndroid Build Coastguard Workerspecifications that were not explicitly provided.
132*cf84ac9aSAndroid Build Coastguard Worker
133*cf84ac9aSAndroid Build Coastguard Worker   The most portable way to affect installation locations is to pass the
134*cf84ac9aSAndroid Build Coastguard Workercorrect locations to 'configure'; however, many packages provide one or
135*cf84ac9aSAndroid Build Coastguard Workerboth of the following shortcuts of passing variable assignments to the
136*cf84ac9aSAndroid Build Coastguard Worker'make install' command line to change installation locations without
137*cf84ac9aSAndroid Build Coastguard Workerhaving to reconfigure or recompile.
138*cf84ac9aSAndroid Build Coastguard Worker
139*cf84ac9aSAndroid Build Coastguard Worker   The first method involves providing an override variable for each
140*cf84ac9aSAndroid Build Coastguard Workeraffected directory.  For example, 'make install
141*cf84ac9aSAndroid Build Coastguard Workerprefix=/alternate/directory' will choose an alternate location for all
142*cf84ac9aSAndroid Build Coastguard Workerdirectory configuration variables that were expressed in terms of
143*cf84ac9aSAndroid Build Coastguard Worker'${prefix}'.  Any directories that were specified during 'configure',
144*cf84ac9aSAndroid Build Coastguard Workerbut not in terms of '${prefix}', must each be overridden at install time
145*cf84ac9aSAndroid Build Coastguard Workerfor the entire installation to be relocated.  The approach of makefile
146*cf84ac9aSAndroid Build Coastguard Workervariable overrides for each directory variable is required by the GNU
147*cf84ac9aSAndroid Build Coastguard WorkerCoding Standards, and ideally causes no recompilation.  However, some
148*cf84ac9aSAndroid Build Coastguard Workerplatforms have known limitations with the semantics of shared libraries
149*cf84ac9aSAndroid Build Coastguard Workerthat end up requiring recompilation when using this method, particularly
150*cf84ac9aSAndroid Build Coastguard Workernoticeable in packages that use GNU Libtool.
151*cf84ac9aSAndroid Build Coastguard Worker
152*cf84ac9aSAndroid Build Coastguard Worker   The second method involves providing the 'DESTDIR' variable.  For
153*cf84ac9aSAndroid Build Coastguard Workerexample, 'make install DESTDIR=/alternate/directory' will prepend
154*cf84ac9aSAndroid Build Coastguard Worker'/alternate/directory' before all installation names.  The approach of
155*cf84ac9aSAndroid Build Coastguard Worker'DESTDIR' overrides is not required by the GNU Coding Standards, and
156*cf84ac9aSAndroid Build Coastguard Workerdoes not work on platforms that have drive letters.  On the other hand,
157*cf84ac9aSAndroid Build Coastguard Workerit does better at avoiding recompilation issues, and works well even
158*cf84ac9aSAndroid Build Coastguard Workerwhen some directory options were not specified in terms of '${prefix}'
159*cf84ac9aSAndroid Build Coastguard Workerat 'configure' time.
160*cf84ac9aSAndroid Build Coastguard Worker
161*cf84ac9aSAndroid Build Coastguard WorkerOptional Features
162*cf84ac9aSAndroid Build Coastguard Worker=================
163*cf84ac9aSAndroid Build Coastguard Worker
164*cf84ac9aSAndroid Build Coastguard WorkerIf the package supports it, you can cause programs to be installed with
165*cf84ac9aSAndroid Build Coastguard Workeran extra prefix or suffix on their names by giving 'configure' the
166*cf84ac9aSAndroid Build Coastguard Workeroption '--program-prefix=PREFIX' or '--program-suffix=SUFFIX'.
167*cf84ac9aSAndroid Build Coastguard Worker
168*cf84ac9aSAndroid Build Coastguard Worker   Some packages pay attention to '--enable-FEATURE' options to
169*cf84ac9aSAndroid Build Coastguard Worker'configure', where FEATURE indicates an optional part of the package.
170*cf84ac9aSAndroid Build Coastguard WorkerThey may also pay attention to '--with-PACKAGE' options, where PACKAGE
171*cf84ac9aSAndroid Build Coastguard Workeris something like 'gnu-as' or 'x' (for the X Window System).  The
172*cf84ac9aSAndroid Build Coastguard Worker'README' should mention any '--enable-' and '--with-' options that the
173*cf84ac9aSAndroid Build Coastguard Workerpackage recognizes.
174*cf84ac9aSAndroid Build Coastguard Worker
175*cf84ac9aSAndroid Build Coastguard Worker   For packages that use the X Window System, 'configure' can usually
176*cf84ac9aSAndroid Build Coastguard Workerfind the X include and library files automatically, but if it doesn't,
177*cf84ac9aSAndroid Build Coastguard Workeryou can use the 'configure' options '--x-includes=DIR' and
178*cf84ac9aSAndroid Build Coastguard Worker'--x-libraries=DIR' to specify their locations.
179*cf84ac9aSAndroid Build Coastguard Worker
180*cf84ac9aSAndroid Build Coastguard Worker   Some packages offer the ability to configure how verbose the
181*cf84ac9aSAndroid Build Coastguard Workerexecution of 'make' will be.  For these packages, running './configure
182*cf84ac9aSAndroid Build Coastguard Worker--enable-silent-rules' sets the default to minimal output, which can be
183*cf84ac9aSAndroid Build Coastguard Workeroverridden with 'make V=1'; while running './configure
184*cf84ac9aSAndroid Build Coastguard Worker--disable-silent-rules' sets the default to verbose, which can be
185*cf84ac9aSAndroid Build Coastguard Workeroverridden with 'make V=0'.
186*cf84ac9aSAndroid Build Coastguard Worker
187*cf84ac9aSAndroid Build Coastguard WorkerSpecifying the System Type
188*cf84ac9aSAndroid Build Coastguard Worker==========================
189*cf84ac9aSAndroid Build Coastguard Worker
190*cf84ac9aSAndroid Build Coastguard WorkerThere may be some features 'configure' cannot figure out automatically,
191*cf84ac9aSAndroid Build Coastguard Workerbut needs to determine by the type of machine the package will run on.
192*cf84ac9aSAndroid Build Coastguard WorkerUsually, assuming the package is built to be run on the _same_
193*cf84ac9aSAndroid Build Coastguard Workerarchitectures, 'configure' can figure that out, but if it prints a
194*cf84ac9aSAndroid Build Coastguard Workermessage saying it cannot guess the machine type, give it the
195*cf84ac9aSAndroid Build Coastguard Worker'--build=TYPE' option.  TYPE can either be a short name for the system
196*cf84ac9aSAndroid Build Coastguard Workertype, such as 'sun4', or a canonical name which has the form:
197*cf84ac9aSAndroid Build Coastguard Worker
198*cf84ac9aSAndroid Build Coastguard Worker     CPU-COMPANY-SYSTEM
199*cf84ac9aSAndroid Build Coastguard Worker
200*cf84ac9aSAndroid Build Coastguard Workerwhere SYSTEM can have one of these forms:
201*cf84ac9aSAndroid Build Coastguard Worker
202*cf84ac9aSAndroid Build Coastguard Worker     OS
203*cf84ac9aSAndroid Build Coastguard Worker     KERNEL-OS
204*cf84ac9aSAndroid Build Coastguard Worker
205*cf84ac9aSAndroid Build Coastguard Worker   See the file 'config.sub' for the possible values of each field.  If
206*cf84ac9aSAndroid Build Coastguard Worker'config.sub' isn't included in this package, then this package doesn't
207*cf84ac9aSAndroid Build Coastguard Workerneed to know the machine type.
208*cf84ac9aSAndroid Build Coastguard Worker
209*cf84ac9aSAndroid Build Coastguard Worker   If you are _building_ compiler tools for cross-compiling, you should
210*cf84ac9aSAndroid Build Coastguard Workeruse the option '--target=TYPE' to select the type of system they will
211*cf84ac9aSAndroid Build Coastguard Workerproduce code for.
212*cf84ac9aSAndroid Build Coastguard Worker
213*cf84ac9aSAndroid Build Coastguard Worker   If you want to _use_ a cross compiler, that generates code for a
214*cf84ac9aSAndroid Build Coastguard Workerplatform different from the build platform, you should specify the
215*cf84ac9aSAndroid Build Coastguard Worker"host" platform (i.e., that on which the generated programs will
216*cf84ac9aSAndroid Build Coastguard Workereventually be run) with '--host=TYPE'.
217*cf84ac9aSAndroid Build Coastguard Worker
218*cf84ac9aSAndroid Build Coastguard WorkerSharing Defaults
219*cf84ac9aSAndroid Build Coastguard Worker================
220*cf84ac9aSAndroid Build Coastguard Worker
221*cf84ac9aSAndroid Build Coastguard WorkerIf you want to set default values for 'configure' scripts to share, you
222*cf84ac9aSAndroid Build Coastguard Workercan create a site shell script called 'config.site' that gives default
223*cf84ac9aSAndroid Build Coastguard Workervalues for variables like 'CC', 'cache_file', and 'prefix'.  'configure'
224*cf84ac9aSAndroid Build Coastguard Workerlooks for 'PREFIX/share/config.site' if it exists, then
225*cf84ac9aSAndroid Build Coastguard Worker'PREFIX/etc/config.site' if it exists.  Or, you can set the
226*cf84ac9aSAndroid Build Coastguard Worker'CONFIG_SITE' environment variable to the location of the site script.
227*cf84ac9aSAndroid Build Coastguard WorkerA warning: not all 'configure' scripts look for a site script.
228*cf84ac9aSAndroid Build Coastguard Worker
229*cf84ac9aSAndroid Build Coastguard WorkerDefining Variables
230*cf84ac9aSAndroid Build Coastguard Worker==================
231*cf84ac9aSAndroid Build Coastguard Worker
232*cf84ac9aSAndroid Build Coastguard WorkerVariables not defined in a site shell script can be set in the
233*cf84ac9aSAndroid Build Coastguard Workerenvironment passed to 'configure'.  However, some packages may run
234*cf84ac9aSAndroid Build Coastguard Workerconfigure again during the build, and the customized values of these
235*cf84ac9aSAndroid Build Coastguard Workervariables may be lost.  In order to avoid this problem, you should set
236*cf84ac9aSAndroid Build Coastguard Workerthem in the 'configure' command line, using 'VAR=value'.  For example:
237*cf84ac9aSAndroid Build Coastguard Worker
238*cf84ac9aSAndroid Build Coastguard Worker     ./configure CC=/usr/local2/bin/gcc
239*cf84ac9aSAndroid Build Coastguard Worker
240*cf84ac9aSAndroid Build Coastguard Workercauses the specified 'gcc' to be used as the C compiler (unless it is
241*cf84ac9aSAndroid Build Coastguard Workeroverridden in the site shell script).
242*cf84ac9aSAndroid Build Coastguard Worker
243*cf84ac9aSAndroid Build Coastguard WorkerUnfortunately, this technique does not work for 'CONFIG_SHELL' due to an
244*cf84ac9aSAndroid Build Coastguard WorkerAutoconf limitation.  Until the limitation is lifted, you can use this
245*cf84ac9aSAndroid Build Coastguard Workerworkaround:
246*cf84ac9aSAndroid Build Coastguard Worker
247*cf84ac9aSAndroid Build Coastguard Worker     CONFIG_SHELL=/bin/bash ./configure CONFIG_SHELL=/bin/bash
248*cf84ac9aSAndroid Build Coastguard Worker
249*cf84ac9aSAndroid Build Coastguard Worker'configure' Invocation
250*cf84ac9aSAndroid Build Coastguard Worker======================
251*cf84ac9aSAndroid Build Coastguard Worker
252*cf84ac9aSAndroid Build Coastguard Worker'configure' recognizes the following options to control how it operates.
253*cf84ac9aSAndroid Build Coastguard Worker
254*cf84ac9aSAndroid Build Coastguard Worker'--help'
255*cf84ac9aSAndroid Build Coastguard Worker'-h'
256*cf84ac9aSAndroid Build Coastguard Worker     Print a summary of all of the options to 'configure', and exit.
257*cf84ac9aSAndroid Build Coastguard Worker
258*cf84ac9aSAndroid Build Coastguard Worker'--help=short'
259*cf84ac9aSAndroid Build Coastguard Worker'--help=recursive'
260*cf84ac9aSAndroid Build Coastguard Worker     Print a summary of the options unique to this package's
261*cf84ac9aSAndroid Build Coastguard Worker     'configure', and exit.  The 'short' variant lists options used only
262*cf84ac9aSAndroid Build Coastguard Worker     in the top level, while the 'recursive' variant lists options also
263*cf84ac9aSAndroid Build Coastguard Worker     present in any nested packages.
264*cf84ac9aSAndroid Build Coastguard Worker
265*cf84ac9aSAndroid Build Coastguard Worker'--version'
266*cf84ac9aSAndroid Build Coastguard Worker'-V'
267*cf84ac9aSAndroid Build Coastguard Worker     Print the version of Autoconf used to generate the 'configure'
268*cf84ac9aSAndroid Build Coastguard Worker     script, and exit.
269*cf84ac9aSAndroid Build Coastguard Worker
270*cf84ac9aSAndroid Build Coastguard Worker'--cache-file=FILE'
271*cf84ac9aSAndroid Build Coastguard Worker     Enable the cache: use and save the results of the tests in FILE,
272*cf84ac9aSAndroid Build Coastguard Worker     traditionally 'config.cache'.  FILE defaults to '/dev/null' to
273*cf84ac9aSAndroid Build Coastguard Worker     disable caching.
274*cf84ac9aSAndroid Build Coastguard Worker
275*cf84ac9aSAndroid Build Coastguard Worker'--config-cache'
276*cf84ac9aSAndroid Build Coastguard Worker'-C'
277*cf84ac9aSAndroid Build Coastguard Worker     Alias for '--cache-file=config.cache'.
278*cf84ac9aSAndroid Build Coastguard Worker
279*cf84ac9aSAndroid Build Coastguard Worker'--quiet'
280*cf84ac9aSAndroid Build Coastguard Worker'--silent'
281*cf84ac9aSAndroid Build Coastguard Worker'-q'
282*cf84ac9aSAndroid Build Coastguard Worker     Do not print messages saying which checks are being made.  To
283*cf84ac9aSAndroid Build Coastguard Worker     suppress all normal output, redirect it to '/dev/null' (any error
284*cf84ac9aSAndroid Build Coastguard Worker     messages will still be shown).
285*cf84ac9aSAndroid Build Coastguard Worker
286*cf84ac9aSAndroid Build Coastguard Worker'--srcdir=DIR'
287*cf84ac9aSAndroid Build Coastguard Worker     Look for the package's source code in directory DIR.  Usually
288*cf84ac9aSAndroid Build Coastguard Worker     'configure' can determine that directory automatically.
289*cf84ac9aSAndroid Build Coastguard Worker
290*cf84ac9aSAndroid Build Coastguard Worker'--prefix=DIR'
291*cf84ac9aSAndroid Build Coastguard Worker     Use DIR as the installation prefix.  *note Installation Names:: for
292*cf84ac9aSAndroid Build Coastguard Worker     more details, including other options available for fine-tuning the
293*cf84ac9aSAndroid Build Coastguard Worker     installation locations.
294*cf84ac9aSAndroid Build Coastguard Worker
295*cf84ac9aSAndroid Build Coastguard Worker'--no-create'
296*cf84ac9aSAndroid Build Coastguard Worker'-n'
297*cf84ac9aSAndroid Build Coastguard Worker     Run the configure checks, but stop before creating any output
298*cf84ac9aSAndroid Build Coastguard Worker     files.
299*cf84ac9aSAndroid Build Coastguard Worker
300*cf84ac9aSAndroid Build Coastguard Worker'configure' also accepts some other, not widely useful, options.  Run
301*cf84ac9aSAndroid Build Coastguard Worker'configure --help' for more details.
302