192494SsobomaxInstallation Instructions 292494Ssobomax************************* 392494Ssobomax 492494SsobomaxCopyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005 Free 592494SsobomaxSoftware Foundation, Inc. 692494Ssobomax 792494SsobomaxThis file is free documentation; the Free Software Foundation gives 892494Ssobomaxunlimited permission to copy, distribute and modify it. 992494Ssobomax 1092494SsobomaxBasic Installation 1192494Ssobomax================== 1292494Ssobomax 1392494SsobomaxThese are generic installation instructions. 1492494Ssobomax 1592494Ssobomax The `configure' shell script attempts to guess correct values for 1692494Ssobomaxvarious system-dependent variables used during compilation. It uses 1792494Ssobomaxthose values to create a `Makefile' in each directory of the package. 1892494SsobomaxIt may also create one or more `.h' files containing system-dependent 1992494Ssobomaxdefinitions. Finally, it creates a shell script `config.status' that 2092494Ssobomaxyou can run in the future to recreate the current configuration, and a 2192494Ssobomaxfile `config.log' containing compiler output (useful mainly for 2292494Ssobomaxdebugging `configure'). 2392494Ssobomax 2492494Ssobomax It can also use an optional file (typically called `config.cache' 2592494Ssobomaxand enabled with `--cache-file=config.cache' or simply `-C') that saves 2692494Ssobomaxthe results of its tests to speed up reconfiguring. (Caching is 2792494Ssobomaxdisabled by default to prevent problems with accidental use of stale 2892494Ssobomaxcache files.) 2992494Ssobomax 3092494Ssobomax If you need to do unusual things to compile the package, please try 3192494Ssobomaxto figure out how `configure' could check whether to do them, and mail 3292494Ssobomaxdiffs or instructions to the address given in the `README' so they can 3392494Ssobomaxbe considered for the next release. If you are using the cache, and at 3492494Ssobomaxsome point `config.cache' contains results you don't want to keep, you 3592494Ssobomaxmay remove or edit it. 3692494Ssobomax 3792494Ssobomax The file `configure.ac' (or `configure.in') is used to create 3892494Ssobomax`configure' by a program called `autoconf'. You only need 3992494Ssobomax`configure.ac' if you want to change it or regenerate `configure' using 4092494Ssobomaxa newer version of `autoconf'. 4192494Ssobomax 4292494SsobomaxThe simplest way to compile this package is: 4392494Ssobomax 4492494Ssobomax 1. `cd' to the directory containing the package's source code and type 4592494Ssobomax `./configure' to configure the package for your system. If you're 4692494Ssobomax using `csh' on an old version of System V, you might need to type 47124572Sjhb `sh ./configure' instead to prevent `csh' from trying to execute 4892494Ssobomax `configure' itself. 4992494Ssobomax 5092494Ssobomax Running `configure' takes awhile. While running, it prints some 5192494Ssobomax messages telling which features it is checking for. 5292494Ssobomax 5392494Ssobomax 2. Type `make' to compile the package. 5492494Ssobomax 5592494Ssobomax 3. Optionally, type `make check' to run any self-tests that come with 5692494Ssobomax the package. 5792494Ssobomax 5892494Ssobomax 4. Type `make install' to install the programs and any data files and 5992494Ssobomax documentation. 6092494Ssobomax 6192494Ssobomax 5. You can remove the program binaries and object files from the 6292494Ssobomax source code directory by typing `make clean'. To also remove the 6392494Ssobomax files that `configure' created (so you can compile the package for 6492494Ssobomax a different kind of computer), type `make distclean'. There is 6592494Ssobomax also a `make maintainer-clean' target, but that is intended mainly 6692494Ssobomax for the package's developers. If you use it, you may have to get 6792494Ssobomax all sorts of other programs in order to regenerate files that came 68124571Sjhb with the distribution. 6992494Ssobomax 70124571SjhbCompilers and Options 7192494Ssobomax===================== 7292494Ssobomax 7392494SsobomaxSome systems require unusual options for compilation or linking that the 7492494Ssobomax`configure' script does not know about. Run `./configure --help' for 7592494Ssobomaxdetails on some of the pertinent environment variables. 7692494Ssobomax 77124571Sjhb You can give `configure' initial values for configuration parameters 78124571Sjhbby setting variables in the command line or in the environment. Here 7992494Ssobomaxis an example: 8092494Ssobomax 8192494Ssobomax ./configure CC=c89 CFLAGS=-O2 LIBS=-lposix 82124572Sjhb 83124572Sjhb *Note Defining Variables::, for more details. 84124572Sjhb 85124572SjhbCompiling For Multiple Architectures 86124572Sjhb==================================== 87124572Sjhb 88124572SjhbYou can compile the package for more than one kind of computer at the 89124572Sjhbsame time, by placing the object files for each architecture in their 90124572Sjhbown directory. To do this, you must use a version of `make' that 91124572Sjhbsupports the `VPATH' variable, such as GNU `make'. `cd' to the 92124572Sjhbdirectory where you want the object files and executables to go and run 93124572Sjhbthe `configure' script. `configure' automatically checks for the 94124572Sjhbsource code in the directory that `configure' is in and in `..'. 95124572Sjhb 96124572Sjhb If you have to use a `make' that does not support the `VPATH' 97124572Sjhbvariable, you have to compile the package for one architecture at a 98124572Sjhbtime in the source code directory. After you have installed the 99124572Sjhbpackage for one architecture, use `make distclean' before reconfiguring 100124572Sjhbfor another architecture. 101124572Sjhb 102124572SjhbInstallation Names 103124572Sjhb================== 10492494Ssobomax 10592494SsobomaxBy default, `make install' installs the package's commands under 10692494Ssobomax`/usr/local/bin', include files under `/usr/local/include', etc. You 10792494Ssobomaxcan specify an installation prefix other than `/usr/local' by giving 10892494Ssobomax`configure' the option `--prefix=PREFIX'. 10992494Ssobomax 11092494Ssobomax You can specify separate installation prefixes for 11192494Ssobomaxarchitecture-specific files and architecture-independent files. If you 11292494Ssobomaxpass the option `--exec-prefix=PREFIX' to `configure', the package uses 11392494SsobomaxPREFIX as the prefix for installing programs and libraries. 11492494SsobomaxDocumentation and other data files still use the regular prefix. 11592494Ssobomax 11692494Ssobomax In addition, if you use an unusual directory layout you can give 11792494Ssobomaxoptions like `--bindir=DIR' to specify different values for particular 11892494Ssobomaxkinds of files. Run `configure --help' for a list of the directories 11992494Ssobomaxyou can set and what kinds of files go in them. 12092494Ssobomax 12192494Ssobomax If the package supports it, you can cause programs to be installed 12292494Ssobomaxwith an extra prefix or suffix on their names by giving `configure' the 12392494Ssobomaxoption `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'. 12492494Ssobomax 12592494SsobomaxOptional Features 12692494Ssobomax================= 12792494Ssobomax 12892494SsobomaxSome packages pay attention to `--enable-FEATURE' options to 12992494Ssobomax`configure', where FEATURE indicates an optional part of the package. 13092494SsobomaxThey may also pay attention to `--with-PACKAGE' options, where PACKAGE 13192494Ssobomaxis something like `gnu-as' or `x' (for the X Window System). The 13292494Ssobomax`README' should mention any `--enable-' and `--with-' options that the 13392494Ssobomaxpackage recognizes. 13492494Ssobomax 13592494Ssobomax For packages that use the X Window System, `configure' can usually 13692494Ssobomaxfind the X include and library files automatically, but if it doesn't, 13792494Ssobomaxyou can use the `configure' options `--x-includes=DIR' and 13892494Ssobomax`--x-libraries=DIR' to specify their locations. 13992494Ssobomax 14092494SsobomaxSpecifying the System Type 14192494Ssobomax========================== 14292494Ssobomax 14392494SsobomaxThere may be some features `configure' cannot figure out automatically, 14492494Ssobomaxbut needs to determine by the type of machine the package will run on. 14592494SsobomaxUsually, assuming the package is built to be run on the _same_ 14692494Ssobomaxarchitectures, `configure' can figure that out, but if it prints a 14792494Ssobomaxmessage saying it cannot guess the machine type, give it the 14892494Ssobomax`--build=TYPE' option. TYPE can either be a short name for the system 14992494Ssobomaxtype, such as `sun4', or a canonical name which has the form: 15092494Ssobomax 15192494Ssobomax CPU-COMPANY-SYSTEM 15292494Ssobomax 15392494Ssobomaxwhere SYSTEM can have one of these forms: 15492494Ssobomax 15592494Ssobomax OS KERNEL-OS 15692494Ssobomax 15792494Ssobomax See the file `config.sub' for the possible values of each field. If 15892494Ssobomax`config.sub' isn't included in this package, then this package doesn't 15992494Ssobomaxneed to know the machine type. 16092494Ssobomax 16192494Ssobomax If you are _building_ compiler tools for cross-compiling, you should 16292494Ssobomaxuse the option `--target=TYPE' to select the type of system they will 16392494Ssobomaxproduce code for. 16492494Ssobomax 165124572Sjhb If you want to _use_ a cross compiler, that generates code for a 16692494Ssobomaxplatform different from the build platform, you should specify the 16792494Ssobomax"host" platform (i.e., that on which the generated programs will 16892494Ssobomaxeventually be run) with `--host=TYPE'. 169124572Sjhb 170124572SjhbSharing Defaults 171124572Sjhb================ 172124572Sjhb 173124572SjhbIf you want to set default values for `configure' scripts to share, you 17492494Ssobomaxcan create a site shell script called `config.site' that gives default 17592494Ssobomaxvalues for variables like `CC', `cache_file', and `prefix'. 17692494Ssobomax`configure' looks for `PREFIX/share/config.site' if it exists, then 17792494Ssobomax`PREFIX/etc/config.site' if it exists. Or, you can set the 17892494Ssobomax`CONFIG_SITE' environment variable to the location of the site script. 17992494SsobomaxA warning: not all `configure' scripts look for a site script. 18092494Ssobomax 18192494SsobomaxDefining Variables 18292494Ssobomax================== 18392494Ssobomax 18492494SsobomaxVariables not defined in a site shell script can be set in the 18592494Ssobomaxenvironment passed to `configure'. However, some packages may run 18692494Ssobomaxconfigure again during the build, and the customized values of these 18792494Ssobomaxvariables may be lost. In order to avoid this problem, you should set 18892494Ssobomaxthem in the `configure' command line, using `VAR=value'. For example: 18992494Ssobomax 19092494Ssobomax ./configure CC=/usr/local2/bin/gcc 19192494Ssobomax 19292494Ssobomaxcauses the specified `gcc' to be used as the C compiler (unless it is 19392494Ssobomaxoverridden in the site shell script). Here is a another example: 19492494Ssobomax 195146443Scharnier /bin/bash ./configure CONFIG_SHELL=/bin/bash 196146443Scharnier 19792494SsobomaxHere the `CONFIG_SHELL=/bin/bash' operand causes subsequent 19892494Ssobomaxconfiguration-related scripts to be executed by `/bin/bash'. 19992494Ssobomax 20092494Ssobomax`configure' Invocation 20192494Ssobomax====================== 20292494Ssobomax 20392494Ssobomax`configure' recognizes the following options to control how it operates. 20492494Ssobomax 20592494Ssobomax`--help' 20692494Ssobomax`-h' 20792494Ssobomax Print a summary of the options to `configure', and exit. 20892494Ssobomax 20992494Ssobomax`--version' 21092494Ssobomax`-V' 211136093Sstefanf Print the version of Autoconf used to generate the `configure' 21292494Ssobomax script, and exit. 21392494Ssobomax 21492494Ssobomax`--cache-file=FILE' 21592494Ssobomax Enable the cache: use and save the results of the tests in FILE, 21692494Ssobomax traditionally `config.cache'. FILE defaults to `/dev/null' to 21792494Ssobomax disable caching. 21892494Ssobomax 21992494Ssobomax`--config-cache' 22092494Ssobomax`-C' 22192494Ssobomax Alias for `--cache-file=config.cache'. 222124572Sjhb 223124572Sjhb`--quiet' 22492494Ssobomax`--silent' 22592494Ssobomax`-q' 22692494Ssobomax Do not print messages saying which checks are being made. To 22792494Ssobomax suppress all normal output, redirect it to `/dev/null' (any error 22892494Ssobomax messages will still be shown). 22992494Ssobomax 23092494Ssobomax`--srcdir=DIR' 23192494Ssobomax Look for the package's source code in directory DIR. Usually 23292494Ssobomax `configure' can determine that directory automatically. 23392494Ssobomax 23492494Ssobomax`configure' also accepts some other, not widely useful, options. Run 23592494Ssobomax`configure --help' for more details. 23692494Ssobomax 23792494Ssobomax