configure
¥¹¥¯¥ê¥×¥È¤ÎºîÀ®
configure
¤Î½é´ü²½configure
¤ÎÃí°Õ»ö¹àconfigure
¤ÎÆþÎϤò¸«¤Ä¤±¤ëconfigure
¥¹¥¯¥ê¥×¥È¤Î¼Â¹Ô
Next: Introduction, Up: (dir) [Contents][Index]
This manual is for GNU Autoconf (version 2.59, 5 November 2003), a package for creating scripts to configure source code packages using templates and an M4 macro package.
Copyright © 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with the Front-Cover texts being “A GNU Manual,” and with the Back-Cover Texts as in (a) below. A copy of the license is included in the section entitled “GNU Free Documentation License.”
(a) The FSF’s Back-Cover Text is: “You have freedom to copy and modify this GNU Manual, like GNU software. Copies published by the Free Software Foundation raise funds for GNU development.”
• Introduction: | Autoconf’s purpose, strengths, and weaknesses | |
• The GNU Build System: | A set of tools for portable software packages | |
• Making configure Scripts: | How to organize and produce Autoconf scripts | |
• Setup: | Initialization and output | |
• Existing Tests: | Macros that check for particular features | |
• Writing Tests: | How to write new feature checks | |
• Results: | What to do with results from feature checks | |
• Programming in M4: | Layers on top of which Autoconf is written | |
• Writing Autoconf Macros: | Adding new macros to Autoconf | |
• Portable Shell: | Shell script portability pitfalls | |
• Manual Configuration: | Selecting features that can’t be guessed | |
• Site Configuration: | Local defaults for configure
| |
• Running configure Scripts: | How to use the Autoconf output | |
• config.status Invocation: | Recreating a configuration | |
• Obsolete Constructs: | Kept for backward compatibility | |
• Using Autotest: | Creating portable test suites | |
• FAQ: | Frequent Autoconf Questions, with answers | |
• History: | History of Autoconf | |
• Copying This Manual: | How to make copies of this manual | |
• Indices: | Indices of symbols, concepts, etc. | |
— ¾ÜºÙ¤Ê¥Î¡¼¥É¥ê¥¹¥È — GNU¥Ó¥ë¥É¥·¥¹¥Æ¥à | ||
---|---|---|
• Automake: | Escaping Makefile hell | |
• Libtool: | Building libraries portably | |
• Pointers: | More info on the GNU build system | |
| ||
• Writing configure.ac: | What to put in an Autoconf input file | |
• autoscan Invocation: | Semi-automatic configure.ac writing | |
• ifnames Invocation: | Listing the conditionals in source code | |
• autoconf Invocation: | How to create configuration scripts | |
• autoreconf Invocation: | Remaking multiple configure scripts
| |
configure.ac¤ò½ñ¤¯ | ||
• Shell Script Compiler: | Autoconf as solution of a problem | |
• Autoconf Language: | Programming in Autoconf | |
• configure.ac Layout: | Standard organization of configure.ac | |
½é´ü²½¤È½ÐÎÏ¥Õ¥¡¥¤¥ë | ||
• Initializing configure: | Option processing etc. | |
• Notices: | Copyright, version numbers in configure
| |
• Input: | Where Autoconf should find files | |
• Output: | Outputting results from the configuration | |
• Configuration Actions: | Preparing the output based on results | |
• Configuration Files: | Creating output files | |
• Makefile Substitutions: | Using output variables in Makefiles | |
• Configuration Headers: | Creating a configuration header file | |
• Configuration Commands: | Running arbitrary instantiation commands | |
• Configuration Links: | Links depending on the configuration | |
• Subdirectories: | Configuring independent packages together | |
• Default Prefix: | Changing the default installation prefix | |
Makefile¤Ø¤ÎÂåÆþ | ||
• Preset Output Variables: | Output variables that are always set | |
• Installation Directory Variables: | Other preset output variables | |
• Build Directories: | Supporting multiple concurrent compiles | |
• Automatic Remaking: | Makefile rules for configuring | |
¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤Î¥³¥ó¥Õ¥£¥°¥ì¡¼¥·¥ç¥ó | ||
• Header Templates: | Input for the configuration headers | |
• autoheader Invocation: | How to create configuration templates | |
• Autoheader Macros: | How to specify CPP templates | |
¸ºß¤ÎÄ´ºº | ||
• Common Behavior: | Macros’ standard schemes | |
• Alternative Programs: | Selecting between alternative programs | |
• Files: | Checking for the existence of files | |
• Libraries: | Library archives that might be missing | |
• Library Functions: | C library functions that might be missing | |
• Header Files: | Header files that might be missing | |
• Declarations: | Declarations that may be missing | |
• Structures: | Structures or members that might be missing | |
• Types: | Types that might be missing | |
• Compilers and Preprocessors: | Checking for compiling programs | |
• System Services: | Operating system services | |
• UNIX Variants: | Special kludges for specific UNIX variants | |
¶¦ÄÌ¤ÎÆ°ºî | ||
• Standard Symbols: | Symbols defined by the macros | |
• Default Includes: | Includes used by the generic macros | |
¥×¥í¥°¥é¥à¤ÎÁªÂò | ||
• Particular Programs: | Special handling to find certain programs | |
• Generic Programs: | How to find other programs | |
¥é¥¤¥Ö¥é¥ê´Ø¿ô | ||
• Function Portability: | Pitfalls with usual functions | |
• Particular Functions: | Special handling to find certain functions | |
• Generic Functions: | How to find other functions | |
¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë | ||
• Header Portability: | Collected knowledge on common headers | |
• Particular Headers: | Special handling to find certain headers | |
• Generic Headers: | How to find other headers | |
Àë¸À | ||
• Particular Declarations: | Macros to check for certain declarations | |
• Generic Declarations: | How to find other declarations | |
¹½Â¤ÂÎ | ||
• Particular Structures: | Macros to check for certain structure members | |
• Generic Structures: | How to find other structure members | |
·¿ | ||
• Particular Types: | Special handling to find certain types | |
• Generic Types: | How to find other types | |
¥³¥ó¥Ñ¥¤¥é¤È¥×¥ê¥×¥í¥»¥Ã¥µ | ||
• Specific Compiler Characteristics: | Some portability issues | |
• Generic Compiler Characteristics: | Language independent tests and features | |
• C Compiler: | Checking its characteristics | |
• C++ Compiler: | Likewise | |
• Fortran Compiler: | Likewise | |
¥Æ¥¹¥È¤ò½ñ¤¯ | ||
• Language Choice: | Selecting which language to use for testing | |
• Writing Test Programs: | Forging source files for compilers | |
• Running the Preprocessor: | Detecting preprocessor symbols | |
• Running the Compiler: | Detecting language or header features | |
• Running the Linker: | Detecting library features | |
• Run Time: | Testing for run-time features | |
• Systemology: | A zoology of operating systems | |
• Multiple Cases: | Tests for several possible values | |
¥Æ¥¹¥È¥×¥í¥°¥é¥à¤ò½ñ¤¯ | ||
• Guidelines: | General rules for writing test programs | |
• Test Functions: | Avoiding pitfalls in test programs | |
• Generating Sources: | Source program boilerplate | |
¥Æ¥¹¥È¤Î·ë²Ì | ||
• Defining Symbols: | Defining C preprocessor symbols | |
• Setting Output Variables: | Replacing variables in output files | |
• Caching Results: | Speeding up subsequent configure runs
| |
• Printing Messages: | Notifying configure users
| |
·ë²Ì¤Î¥¥ã¥Ã¥·¥å | ||
• Cache Variable Names: | Shell variables used in caches | |
• Cache Files: | Files configure uses for caching
| |
• Cache Checkpointing: | Loading and saving the cache file | |
M4¤Ç¤Î¥×¥í¥°¥é¥à | ||
• M4 Quotation: | Protecting macros from unwanted expansion | |
• Using autom4te: | The Autoconf executables backbone | |
• Programming in M4sugar: | Convenient pure M4 macros | |
• Programming in M4sh: | Common shell Constructs | |
M4¤Î°úÍÑÉä | ||
• Active Characters: | Characters that change the behavior of M4 | |
• One Macro Call: | Quotation and one macro call | |
• Quotation and Nested Macros: | Macros calling macros | |
• Changequote is Evil: | Worse than INTERCAL: M4 + changequote | |
• Quadrigraphs: | Another way to escape special characters | |
• Quotation Rule Of Thumb: | One parenthesis, one quote | |
| ||
• autom4te Invocation: | A GNU M4 wrapper | |
• Customizing autom4te: | Customizing the Autoconf package | |
M4sugar¤Ç¤Î¥×¥í¥°¥é¥à | ||
• Redefined M4 Macros: | M4 builtins changed in M4sugar | |
• Evaluation Macros: | More quotation and evaluation control | |
• Forbidden Patterns: | Catching unexpanded macros | |
Autoconf¥Þ¥¯¥í¤ò½ñ¤¯ | ||
• Macro Definitions: | Basic format of an Autoconf macro | |
• Macro Names: | What to call your new macros | |
• Reporting Messages: | Notifying autoconf users
| |
• Dependencies Between Macros: | What to do when macros depend on other macros | |
• Obsoleting Macros: | Warning about old ways of doing things | |
• Coding Style: | Writing Autoconf macros à la Autoconf | |
¥Þ¥¯¥í´Ö¤Î°Í¸À | ||
• Prerequisite Macros: | Ensuring required information | |
• Suggested Ordering: | Warning about possible ordering problems | |
°Ü¿¢À¤Î¤¢¤ë¥·¥§¥ë¥×¥í¥°¥é¥à | ||
• Shellology: | A zoology of shells | |
• Here-Documents: | Quirks and tricks | |
• File Descriptors: | FDs and redirections | |
• File System Conventions: | File- and pathnames | |
• Shell Substitutions: | Variable and command expansions | |
• Assignments: | Varying side effects of assignments | |
• Parentheses: | Parentheses in shell scripts | |
• Special Shell Variables: | Variables you should not change | |
• Limitations of Builtins: | Portable use of not so portable /bin/sh | |
• Limitations of Usual Tools: | Portable use of portable tools | |
• Limitations of Make: | Portable Makefiles | |
¼êư¤Î¥³¥ó¥Õ¥£¥°¥ì¡¼¥·¥ç¥ó | ||
• Specifying Names: | Specifying the system type | |
• Canonicalizing: | Getting the canonical system type | |
• Using System Type: | What to do with the system type | |
¥µ¥¤¥È¥³¥ó¥Õ¥£¥°¥ì¡¼¥·¥ç¥ó | ||
• External Software: | Working with other optional software | |
• Package Options: | Selecting optional features | |
• Pretty Help Strings: | Formatting help string | |
• Site Details: | Configuring site details | |
• Transforming Names: | Changing program names when installing | |
• Site Defaults: | Giving configure local defaults
| |
¥¤¥ó¥¹¥È¡¼¥ë»þ¤Î¥×¥í¥°¥é¥à̾¤ÎÊÑ´¹ | ||
• Transformation Options: | configure options to transform names
| |
• Transformation Examples: | Sample uses of transforming names | |
• Transformation Rules: | Makefile uses of transforming names | |
| ||
• Basic Installation: | Instructions for typical cases | |
• Compilers and Options: | Selecting compilers and optimization | |
• Multiple Architectures: | Compiling for multiple architectures at once | |
• Installation Names: | Installing in different directories | |
• Optional Features: | Selecting optional features | |
• System Type: | Specifying the system type | |
• Sharing Defaults: | Setting site-wide defaults for configure
| |
• Defining Variables: | Specifying the compiler etc. | |
• configure Invocation: | Changing how configure runs
| |
»þÂåÃÙ¤ì¤Î¹½À®Êª | ||
• Obsolete config.status Use: | Different calling convention | |
• acconfig.h: | Additional entries in config.h.in | |
• autoupdate Invocation: | Automatic update of configure.ac | |
• Obsolete Macros: | Backward compatibility macros | |
• Autoconf 1: | Tips for upgrading your files | |
• Autoconf 2.13: | Some fresher tips | |
¥Ð¡¼¥¸¥ç¥ó1¤«¤é¤Î¹¹¿· | ||
• Changed File Names: | Files you might rename | |
• Changed Makefiles: | New things to put in Makefile.in | |
• Changed Macros: | Macro calls you might replace | |
• Changed Results: | Changes in how to check test results | |
• Changed Macro Writing: | Better ways to write your own macros | |
¥Ð¡¼¥¸¥ç¥ó2.13¤«¤é¤Î¹¹¿· | ||
• Changed Quotation: | Broken code which used to work | |
• New Macros: | Interaction with foreign macros | |
• Hosts and Cross-Compilation: | Bugward compatibility kludges | |
• AC_LIBOBJ vs LIBOBJS: | LIBOBJS is a forbidden token | |
• AC_FOO_IFELSE vs AC_TRY_FOO: | A more generic scheme for testing sources | |
Autotest¤òÍѤ¤¤Æ¥Æ¥¹¥È¥¹¥¤¡¼¥È¤òÀ¸À®¤¹¤ë | ||
• Using an Autotest Test Suite: | Autotest and the user | |
• Writing testsuite.at: | Autotest macros | |
• testsuite Invocation: | Running testsuite scripts
| |
• Making testsuite Scripts: | Using autom4te to create testsuite
| |
Autotest¥Æ¥¹¥È¥¹¥¤¡¼¥È¤Î»ÈÍÑ | ||
• testsuite Scripts: | The concepts of Autotest | |
• Autotest Logs: | Their contents | |
¤è¤¯¤¢¤ë¼ÁÌä¤È¤½¤Î²óÅú | ||
• Distributing: | Distributing configure scripts
| |
• Why GNU m4: | Why not use the standard M4? | |
• Bootstrapping: | Autoconf and GNU M4 require each other? | |
• Why Not Imake: | Why GNU uses configure instead of Imake
| |
• Defining Directories: | Passing datadir to program
| |
• autom4te.cache: | What is it? Can I remove it? | |
• Present But Cannot Be Compiled: | Compiler and Preprocessor Disagree | |
Autoconf¤ÎÎò»Ë | ||
• Genesis: | Prehistory and naming of configure
| |
• Exodus: | The plagues of M4 and Perl | |
• Leviticus: | The priestly code of portability arrives | |
• Numbers: | Growth and contributors | |
• Deuteronomy: | Approaching the promises of easy configuration | |
¤³¤Î¥Þ¥Ë¥å¥¢¥ë¤Î¥³¥Ô¡¼¾ò·ï | ||
• GNU Free Documentation License: | License for copying this manual | |
º÷°ú | ||
• Environment Variable Index: | Index of environment variables used | |
• Output Variable Index: | Index of variables set in output files | |
• Preprocessor Symbol Index: | Index of C preprocessor symbols defined | |
• Autoconf Macro Index: | Index of Autoconf macros | |
• M4 Macro Index: | Index of M4, M4sugar, and M4sh macros | |
• Autotest Macro Index: | Index of Autotest macros | |
• Program & Function Index: | Index of those with portability problems | |
• Concept Index: | General index | |
Next: Introduction, Up: (dir) [Contents][Index]