diff options
| author | Rickard Green <[email protected]> | 2010-02-15 22:35:28 +0000 |
|---|---|---|
| committer | Erlang/OTP <[email protected]> | 2010-02-15 22:35:28 +0000 |
| commit | 924f3aaf2c4841eafb5ea3832e2c885eb54ac984 (patch) | |
| tree | 1314ac209fbea94f720eca1947c1f80c305e73e7 /xcomp | |
| parent | 7fb88a9a605f090ee7a69eb91c95ecf883ef8cad (diff) | |
| download | otp-924f3aaf2c4841eafb5ea3832e2c885eb54ac984.tar.gz otp-924f3aaf2c4841eafb5ea3832e2c885eb54ac984.tar.bz2 otp-924f3aaf2c4841eafb5ea3832e2c885eb54ac984.zip | |
OTP-8323 Cross compilation improvements and other build system
improvements.
Most notable:
Lots of cross compilation improvements. The old cross compilation
support was more or less non-existing as well as broken. Please,
note that the cross compilation support should still be
considered as experimental. Also note that old cross compilation
configurations cannot be used without modifications. For more
information on cross compiling Erlang/OTP see the
$ERL_TOP/INSTALL-CROSS.md file.
Support for staged install using <url
href="http://www.gnu.org/prep/standards/html_node/DESTDIR.html">D
ESTDIR</url>. The old broken INSTALL_PREFIX has also been fixed.
For more information see the $ERL_TOP/INSTALL.md file.
Documentation of the release target of the top Makefile. For more
information see the $ERL_TOP/INSTALL.md file.
make install now by default creates relative symbolic links
instead of absolute ones. For more information see the
$ERL_TOP/INSTALL.md file.
$ERL_TOP/configure --help=recursive now works and prints help for
all applications with configure scripts.
Doing make install, or make release directly after make all no
longer triggers miscellaneous rebuilds.
Existing bootstrap system is now used when doing make install, or
make release without a preceding make all.
The crypto and ssl applications use the same runtime library path
when dynamically linking against libssl.so and libcrypto.so. The
runtime library search path has also been extended.
The configure scripts of erl_interface and odbc now search for
thread libraries and thread library quirks the same way as erts
do.
The configure script of the odbc application now also looks for
odbc libraries in lib64 and lib/64 directories when building on a
64-bit system.
The config.h.in file in the erl_interface application is now
automatically generated in instead of statically updated which
reduces the risk of configure tests without any effect.
(Thanks to Henrik Riomar for suggestions and testing)
(Thanks to Winston Smith for the AVR32-Linux cross configuration
and testing)
Diffstat (limited to 'xcomp')
| -rw-r--r-- | xcomp/README.md | 404 | ||||
| -rw-r--r-- | xcomp/erl-xcomp-TileraMDE2.0-tilepro.conf | 334 | ||||
| -rw-r--r-- | xcomp/erl-xcomp-avr32-atmel-linux-gnu.conf | 371 | ||||
| -rw-r--r-- | xcomp/erl-xcomp-vxworks_ppc32.conf | 334 | ||||
| -rw-r--r-- | xcomp/erl-xcomp-x86_64-saf-linux-gnu.conf | 334 | ||||
| -rw-r--r-- | xcomp/erl-xcomp.conf.template | 334 |
6 files changed, 1062 insertions, 1049 deletions
diff --git a/xcomp/README.md b/xcomp/README.md index e97b26e605..568d7b8315 100644 --- a/xcomp/README.md +++ b/xcomp/README.md @@ -2,25 +2,38 @@ Cross Compiling Erlang/OTP ========================== This document describes how to cross compile Erlang/OTP. Note that the support -for cross compiling Erlang/OTP is in its early stage of development, and -should be considered as experimental. You are encouraged to read the whole -document before attempting to cross compile Erlang/OTP. +for cross compiling Erlang/OTP should be considered as experimental. As far as +we know, the R13B04 release should cross compile fine, but since we currently +have a very limited set of cross compilation environments to test with we +cannot be sure. The cross compile support will stay in an experimental state +until we get a lot more cross compilation environments to test with. + +You are encouraged to read the whole document before attempting to cross +compile Erlang/OTP. Before reading this document you should read the +[`$ERL_TOP/INSTALL.md`] [1] document which describes building Erlang/OTP in +general. `$ERL_TOP` is the top directory in the source tree. + +`otp_build` Versus `configure`/`make` +------------------------------------ Building Erlang/OTP can be done either by using the `$ERL_TOP/otp_build` -script, or by invoking `$ERL_TOP/configure` and `make` directly (where -`$ERL_TOP` is the top directory in the source tree). Building using `otp_build` -is easier since it involves fewer steps, but the `otp_build` build procedure -is not as flexible as the `configure`/`make` build procedure. The binary -releases that we deliver are built using `otp_build`. Also note that -`otp_build configure` will produce a default configuration that differs from -what `configure` will produce by default. For example, currently +script, or by invoking `$ERL_TOP/configure` and `make` directly. Building using +`otp_build` is easier since it involves fewer steps, but the `otp_build` build +procedure is not as flexible as the `configure`/`make` build procedure. Note +that `otp_build configure` will produce a default configuration that differs +from what `configure` will produce by default. For example, currently `--disable-dynamic-ssl-lib` is added to the `configure` command line arguments -unless `--enable-dynamic-ssl-lib` has been explicitly passed. The defaults -used by `otp_build configure` may change at any time without prior notice. +unless `--enable-dynamic-ssl-lib` has been explicitly passed. The binary +releases that we deliver are built using `otp_build`. The defaults used by +`otp_build configure` may change at any time without prior notice. + +Cross Configuration +------------------- The `$ERL_TOP/xcomp/erl-xcomp.conf.template` file contains all available cross configuration variables and can be used as a template when creating a cross -compilation configuration. For examples of working cross configurations see +compilation configuration. All cross configuration variables are also listed +at the end of this document. For examples of working cross configurations see the `$ERL_TOP/xcomp/erl-xcomp-TileraMDE2.0-tilepro.conf` file and the `$ERL_TOP/xcomp/erl-xcomp-x86_64-saf-linux-gnu.conf` file. If the default behavior of a variable is satisfactory, the variable does not need to be set. @@ -38,10 +51,16 @@ invoking `make`; otherwise, the environment variables might set make variables in some applications, or parts of some applications, and you may end up with an erroneously configured build. +What can be Cross Compiled? +--------------------------- + All Erlang/OTP applications except the `wx` application can be cross compiled. The build of the `wx` driver will currently be automatically disabled when cross compiling. +Compatibility +------------- + The build system, including cross compilation configuration variables used, may be subject to non backward compatible changes without prior notice. Current cross build system has been tested when cross compiling some Linux/GNU @@ -49,6 +68,9 @@ systems, but has only been partly tested for more esoteric platforms. The VxWorks example file is highly dependent on our environment and is here more or less only for internal use. +Patches +------- + Please submit any patches for cross compiling in a way consistent with this system. All input is welcome as we have a very limited set of cross compiling environments to test with. If a new configuration variable is needed, add it @@ -66,24 +88,23 @@ Note that this might be an incomplete list of files that need to be updated. General information on how to submit patches can be found at: <http://wiki.github.com/erlang/otp/submitting-patches> -If you are building in a `git` working directory, the `configure` scripts need -to be generated before you can start building. This is done by invoking -`./otp_build autoconf` in the `$ERL_TOP` directory. The `configure` scripts -also have to be regenerated when a `configure.in` or `aclocal.m4` file is -modified. Note that this is *not* needed when building an unmodified version -of the released source. +Build and Install Procedure +--------------------------- + +If you are building in Git you want to read the "Building in Git" section +of [`$ERL_TOP/INSTALL.md`] [1] before proceeding. -Build and Install ------------------ +We will first go through the `configure`/`make` build procedure which people +probably are most familiar with. - [1] +### Building With `configure`/`make` Directly ### + + (1) Change directory into the top directory of the Erlang/OTP source tree. $ cd $ERL_TOP -### Build ### - In order to compile Erlang code, a small Erlang bootstrap system has to be built, or an Erlang/OTP system of the same release as the one being built has to be provided in the `$PATH`. The Erlang/OTP for the target system will @@ -91,11 +112,11 @@ be built using this Erlang system, together with the cross compilation tools provided. If you want to build using a compatible Erlang/OTP system in the `$PATH`, -jump to [3]. +jump to (3). #### Building a Bootstrap System #### - [2] + (2) $ ./configure --enable-bootstrap-only $ make @@ -109,7 +130,7 @@ be built. #### Cross Building the System #### - [3] + (3) $ ./configure --host=<HOST> --build=<BUILD> [Other Config Args] $ make @@ -139,9 +160,11 @@ silently produce suboptimal code, or silently produce erroneous code. #### Installing #### You can either install using the installation paths determined by `configure` -[4], or install manually using [5]. +(4), or install manually using (5). - [4] +##### Installing Using Paths Determined by `configure` ##### + + (4) $ make install DESTDIR=<TEMPORARY_PREFIX> @@ -149,8 +172,8 @@ You can either install using the installation paths determined by `configure` `configure` arguments specifying where the installation should reside are for example: `--prefix`, `--exec-prefix`, `--libdir`, `--bindir`, etc. By default it will install under `/usr/local`. You typically do not want to install your -cross build under `/usr/local` on your build machine. Using `DESTDIR` will -cause the installation paths to be prefixed by `$DESTDIR`. This makes it +cross build under `/usr/local` on your build machine. Using [`DESTDIR`] [2] +will cause the installation paths to be prefixed by `$DESTDIR`. This makes it possible to install and package the installation on the build machine without having to place the installation in the same directory on the build machine as it should be executed from on the target machine. @@ -160,9 +183,9 @@ the system, move it to the target machine, and unpack it. Note that the installation will only be working on the target machine at the location determined by `configure`. -Installing manually: +##### Installing Manually ##### - [5] + (5) $ make release RELEASE_ROOT=<RELEASE_DIR> @@ -181,50 +204,51 @@ currently be invoked as follows in the directory where it resides where: - * `-minimal` - Creates an installation that starts up a minimal - amount of applications, i.e., only `kernel` and - `stdlib` are started. The minimal system is normally - enough, and is what `make install` uses. - * `-sasl` - Creates an installation that also starts up the - `sasl` application. - * `-cross` - For cross compilation. Informs the install script - that it is run on the build machine. - * `<ERL_ROOT>` - The absolute path to the Erlang installation to use - at run time. This is often the same as the current - working directory, but does not have to be. It can - follow any other path through the file system to the - same directory. +* `-minimal` Creates an installation that starts up a minimal amount + of applications, i.e., only `kernel` and `stdlib` are started. The + minimal system is normally enough, and is what `make install` uses. +* `-sasl` Creates an installation that also starts up the `sasl` + application. +* `-cross` For cross compilation. Informs the install script that it + is run on the build machine. +* `<ERL_ROOT>` - The absolute path to the Erlang installation to use + at run time. This is often the same as the current working directory, + but does not have to be. It can follow any other path through the file + system to the same directory. If neither `-minimal`, nor `-sasl` is passed as argument you will be prompted. -You can now either do [6] or [7]: +You can now either do: + + (6) - [6] +* Decide where the installation should be located on the target machine, + run the `Install` script on the build machine, and package the installed + installation. The installation just need to be unpacked at the right + location on the target machine: -Decide where the installation should be located on the target machine, run -the `Install` script on the build machine, and package the installed -installation. The installation just need to be unpacked at the right location -on the target machine: + $ cd <RELEASE_DIR> + $ ./Install -cross [-minimal|-sasl] <ABSOLUTE_INSTALL_DIR_ON_TARGET> - $ cd <RELEASE_DIR> - $ ./Install -cross [-minimal|-sasl] <ABSOLUTE_INSTALL_DIR_ON_TARGET> +or: - [7] + (7) -Package the installation in <RELEASE_DIR>, place it wherever you want on your -target machine, and run the `Install` script on your target machine: +* Package the installation in `<RELEASE_DIR>`, place it wherever you want + on your target machine, and run the `Install` script on your target + machine: - $ cd <ABSOLUTE_INSTALL_DIR_ON_TARGET> - $ ./Install [-minimal|-sasl] <ABSOLUTE_INSTALL_DIR_ON_TARGET> + $ cd <ABSOLUTE_INSTALL_DIR_ON_TARGET> + $ ./Install [-minimal|-sasl] <ABSOLUTE_INSTALL_DIR_ON_TARGET> -#### Building With the `otp_build` Script #### +### Building With the `otp_build` Script ### - [8] + (8) $ cd $ERL_TOP - [9] + (9) $ ./otp_build configure --xcomp-conf=<FILE> [Other Config Args] @@ -235,7 +259,7 @@ alternatively: If you have your cross compilation configuration in a file, pass it using the `--xcomp-conf=<FILE>` command line argument. If not, pass `--host=<HOST>`, `--build=<BUILD>`, and the configuration variables using a `<VARIABLE>=<VALUE>` -syntax on the command line (same as in [3]). Note that `<HOST>` and `<BUILD>` +syntax on the command line (same as in (3)). Note that `<HOST>` and `<BUILD>` have to be passed one way or the other; either by using `erl_xcomp_host=<HOST>` and `erl_xcomp_build=<BUILD>` in the configuration file, or by using the `--host=<HOST>`, and `--build=<BUILD>` command line arguments. @@ -243,19 +267,19 @@ and `erl_xcomp_build=<BUILD>` in the configuration file, or by using the `otp_build configure` will configure both for the boostrap system on the build machine and the cross host system. - [10] + (10) $ ./otp_build boot -a `otp_build boot -a` will first build a bootstrap system for the build machine and then do the cross build of the system. - [11] + (11) $ ./otp_build release -a <RELEASE_DIR> -`otp_build release -a` will do the same as [5], and you will after this have -to do a manual install either by doing [6], or [7]. +`otp_build release -a` will do the same as (5), and you will after this have +to do a manual install either by doing (6), or (7). Currently Used Configuration Variables -------------------------------------- @@ -274,22 +298,22 @@ cross compilation using `$ERL_TOP/otp_build configure`. *NOTE*! These variables currently have *no* effect if you configure using the `configure` script directly. -* `erl_xcomp_build` - The build system used. This value will be passed as - `--build=$erl_xcomp_build` argument to the `configure` script. It does - not have to be a full `CPU-VENDOR-OS` triplet, but can be. The full - `CPU-VENDOR-OS` triplet will be created by - `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build`. - If set to `guess`, the build system will be guessed using - `$ERL_TOP/erts/autoconf/config.guess`. +* `erl_xcomp_build` - The build system used. This value will be passed as + `--build=$erl_xcomp_build` argument to the `configure` script. It does + not have to be a full `CPU-VENDOR-OS` triplet, but can be. The full + `CPU-VENDOR-OS` triplet will be created by + `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build`. If set to `guess`, + the build system will be guessed using + `$ERL_TOP/erts/autoconf/config.guess`. -* `erl_xcomp_host` - Cross host/target system to build for. This value will - be passed as `--host=$erl_xcomp_host` argument to the `configure` script. - It does not have to be a full `CPU-VENDOR-OS` triplet, but can be. The - full `CPU-VENDOR-OS` triplet will be created by: - `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host` +* `erl_xcomp_host` - Cross host/target system to build for. This value will + be passed as `--host=$erl_xcomp_host` argument to the `configure` script. + It does not have to be a full `CPU-VENDOR-OS` triplet, but can be. The + full `CPU-VENDOR-OS` triplet will be created by + `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host`. -* `erl_xcomp_configure_flags` - Extra configure flags to pass to the - `configure` script. +* `erl_xcomp_configure_flags` - Extra configure flags to pass to the + `configure` script. ### Cross Compiler and Other Tools ### @@ -299,75 +323,75 @@ not need to set these variables (where `<HOST>` is what has been passed as All variables in this section can also be used when native compiling. -* `CC` - C compiler. +* `CC` - C compiler. -* `CFLAGS` - C compiler flags. +* `CFLAGS` - C compiler flags. -* `STATIC_CFLAGS` - Static C compiler flags. +* `STATIC_CFLAGS` - Static C compiler flags. -* `CFLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library - search path for the shared libraries. Note that this actually is a - linker flag, but it needs to be passed via the compiler. +* `CFLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library + search path for the shared libraries. Note that this actually is a + linker flag, but it needs to be passed via the compiler. -* `CPP` - C pre-processor. +* `CPP` - C pre-processor. -* `CPPFLAGS` - C pre-processor flags. +* `CPPFLAGS` - C pre-processor flags. -* `CXX` - C++ compiler. +* `CXX` - C++ compiler. -* `CXXFLAGS` - C++ compiler flags. +* `CXXFLAGS` - C++ compiler flags. -* `LD` - Linker. +* `LD` - Linker. -* `LDFLAGS` - Linker flags. +* `LDFLAGS` - Linker flags. -* `LIBS` - Libraries. +* `LIBS` - Libraries. #### *D*ynamic *E*rlang *D*river Linking #### *NOTE*! Either set all or none of the `DED_LD*` variables. -* `DED_LD` - Linker for Dynamically loaded Erlang Drivers. +* `DED_LD` - Linker for Dynamically loaded Erlang Drivers. -* `DED_LDFLAGS` - Linker flags to use with `DED_LD`. +* `DED_LDFLAGS` - Linker flags to use with `DED_LD`. -* `DED_LD_FLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library - search path for shared libraries when linking with `DED_LD`. +* `DED_LD_FLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library + search path for shared libraries when linking with `DED_LD`. #### Large File Support #### *NOTE*! Either set all or none of the `LFS_*` variables. -* `LFS_CFLAGS` - Large file support C compiler flags. +* `LFS_CFLAGS` - Large file support C compiler flags. -* `LFS_LDFLAGS` - Large file support linker flags. +* `LFS_LDFLAGS` - Large file support linker flags. -* `LFS_LIBS` - Large file support libraries. +* `LFS_LIBS` - Large file support libraries. #### Other Tools #### -* `RANLIB` - `ranlib` archive index tool. +* `RANLIB` - `ranlib` archive index tool. -* `AR` - `ar` archiving tool. +* `AR` - `ar` archiving tool. -* `GETCONF` - `getconf` system configuration inspection tool. `getconf` is - currently used for finding out large file support flags to use, and - on Linux systems for finding out if we have an NPTL thread library or - not. +* `GETCONF` - `getconf` system configuration inspection tool. `getconf` is + currently used for finding out large file support flags to use, and + on Linux systems for finding out if we have an NPTL thread library or + not. ### Cross System Root Locations ### -* `erl_xcomp_sysroot` - The absolute path to the system root of the cross - compilation environment. Currently, the `crypto`, `odbc`, `ssh` and - `ssl` applications need the system root. These applications will be - skipped if the system root has not been set. The system root might be - needed for other things too. If this is the case and the system root - has not been set, `configure` will fail and request you to set it. +* `erl_xcomp_sysroot` - The absolute path to the system root of the cross + compilation environment. Currently, the `crypto`, `odbc`, `ssh` and + `ssl` applications need the system root. These applications will be + skipped if the system root has not been set. The system root might be + needed for other things too. If this is the case and the system root + has not been set, `configure` will fail and request you to set it. -* `erl_xcomp_isysroot` - The absolute path to the system root for includes - of the cross compilation environment. If not set, this value defaults - to `$erl_xcomp_sysroot`, i.e., only set this value if the include system - root path is not the same as the system root path. +* `erl_xcomp_isysroot` - The absolute path to the system root for includes + of the cross compilation environment. If not set, this value defaults + to `$erl_xcomp_sysroot`, i.e., only set this value if the include system + root path is not the same as the system root path. ### Optional Feature, and Bug Tests ### @@ -382,72 +406,72 @@ it cannot figure the result out. The `configure` script will issue a warning when a default value is used. When a variable has been set, no warning will be issued. -* `erl_xcomp_after_morecore_hook` - `yes|no`. Defaults to `no`. If `yes`, the - target system must have a working `__after_morecore_hook` that can be - used for tracking used `malloc()` implementations core memory usage. - This is currently only used by unsupported features. - -* `erl_xcomp_bigendian` - `yes|no`. No default. If `yes`, the target system - must be big endian. If `no`, little endian. This can often be - automatically detected, but not always. If not automatically detected, - `configure` will fail unless this variable is set. Since no default - value is used, `configure` will try to figure this out automatically. - -* `erl_xcomp_clock_gettime_cpu_time` - `yes|no`. Defaults to `no`. If `yes`, - the target system must have a working `clock_gettime()` implementation - that can be used for retrieving process CPU time. - -* `erl_xcomp_getaddrinfo` - `yes|no`. Defaults to `no`. If `yes`, the target - system must have a working `getaddrinfo()` implementation that can - handle both IPv4 and IPv6. - -* `erl_xcomp_gethrvtime_procfs_ioctl` - `yes|no`. Defaults to `no`. If `yes`, - the target system must have a working `gethrvtime()` implementation and - is used with procfs `ioctl()`. - -* `erl_xcomp_dlsym_brk_wrappers` - `yes|no`. Defaults to `no`. If `yes`, the - target system must have a working `dlsym(RTLD_NEXT, <S>)` implementation - that can be used on `brk` and `sbrk` symbols used by the `malloc()` - implementation in use, and by this track the `malloc()` implementations - core memory usage. This is currently only used by unsupported features. - -* `erl_xcomp_kqueue` - `yes|no`. Defaults to `no`. If `yes`, the target system - must have a working `kqueue()` implementation that returns a file - descriptor which can be used by `poll()` and/or `select()`. If `no` and - the target system has not got `epoll()` or `/dev/poll`, the kernel-poll - feature will be disabled. - -* `erl_xcomp_linux_clock_gettime_correction` - `yes|no`. Defaults to `yes` on - Linux; otherwise, `no`. If `yes`, `clock_gettime(CLOCK_MONOTONIC, _)` on - the target system must work. This variable is recommended to be set to - `no` on Linux systems with kernel versions less than 2.6. - -* `erl_xcomp_linux_nptl` - `yes|no`. Defaults to `yes` on Linux; otherwise, - `no`. If `yes`, the target system must have NPTL (Native POSIX Thread - Library). Older Linux systems have LinuxThreads instead of NPTL (Linux - kernel versions typically less than 2.6). - -* `erl_xcomp_linux_usable_sigaltstack` - `yes|no`. Defaults to `yes` on Linux; - otherwise, `no`. If `yes`, `sigaltstack()` must be usable on the target - system. `sigaltstack()` on Linux kernel versions less than 2.4 are - broken. - -* `erl_xcomp_linux_usable_sigusrx` - `yes|no`. Defaults to `yes`. If `yes`, - the `SIGUSR1` and `SIGUSR2` signals must be usable by the ERTS. Old - LinuxThreads thread libraries (Linux kernel versions typically less than - 2.2) used these signals and made them unusable by the ERTS. - -* `erl_xcomp_poll` - `yes|no`. Defaults to `no` on Darwin/MacOSX; otherwise, - `yes`. If `yes`, the target system must have a working `poll()` - implementation that also can handle devices. If `no`, `select()` will be - used instead of `poll()`. - -* `erl_xcomp_putenv_copy` - `yes|no`. Defaults to `no`. If `yes`, the target - system must have a `putenv()` implementation that stores a copy of the - key/value pair. - -* `erl_xcomp_reliable_fpe` - `yes|no`. Defaults to `no`. If `yes`, the target - system must have reliable floating point exceptions. +* `erl_xcomp_after_morecore_hook` - `yes|no`. Defaults to `no`. If `yes`, + the target system must have a working `__after_morecore_hook` that can be + used for tracking used `malloc()` implementations core memory usage. + This is currently only used by unsupported features. + +* `erl_xcomp_bigendian` - `yes|no`. No default. If `yes`, the target system + must be big endian. If `no`, little endian. This can often be + automatically detected, but not always. If not automatically detected, + `configure` will fail unless this variable is set. Since no default + value is used, `configure` will try to figure this out automatically. + +* `erl_xcomp_clock_gettime_cpu_time` - `yes|no`. Defaults to `no`. If `yes`, + the target system must have a working `clock_gettime()` implementation + that can be used for retrieving process CPU time. + +* `erl_xcomp_getaddrinfo` - `yes|no`. Defaults to `no`. If `yes`, the target + system must have a working `getaddrinfo()` implementation that can + handle both IPv4 and IPv6. + +* `erl_xcomp_gethrvtime_procfs_ioctl` - `yes|no`. Defaults to `no`. If `yes`, + the target system must have a working `gethrvtime()` implementation and + is used with procfs `ioctl()`. + +* `erl_xcomp_dlsym_brk_wrappers` - `yes|no`. Defaults to `no`. If `yes`, the + target system must have a working `dlsym(RTLD_NEXT, <S>)` implementation + that can be used on `brk` and `sbrk` symbols used by the `malloc()` + implementation in use, and by this track the `malloc()` implementations + core memory usage. This is currently only used by unsupported features. + +* `erl_xcomp_kqueue` - `yes|no`. Defaults to `no`. If `yes`, the target + system must have a working `kqueue()` implementation that returns a file + descriptor which can be used by `poll()` and/or `select()`. If `no` and + the target system has not got `epoll()` or `/dev/poll`, the kernel-poll + feature will be disabled. + +* `erl_xcomp_linux_clock_gettime_correction` - `yes|no`. Defaults to `yes` on + Linux; otherwise, `no`. If `yes`, `clock_gettime(CLOCK_MONOTONIC, _)` on + the target system must work. This variable is recommended to be set to + `no` on Linux systems with kernel versions less than 2.6. + +* `erl_xcomp_linux_nptl` - `yes|no`. Defaults to `yes` on Linux; otherwise, + `no`. If `yes`, the target system must have NPTL (Native POSIX Thread + Library). Older Linux systems have LinuxThreads instead of NPTL (Linux + kernel versions typically less than 2.6). + +* `erl_xcomp_linux_usable_sigaltstack` - `yes|no`. Defaults to `yes` on Linux; + otherwise, `no`. If `yes`, `sigaltstack()` must be usable on the target + system. `sigaltstack()` on Linux kernel versions less than 2.4 are + broken. + +* `erl_xcomp_linux_usable_sigusrx` - `yes|no`. Defaults to `yes`. If `yes`, + the `SIGUSR1` and `SIGUSR2` signals must be usable by the ERTS. Old + LinuxThreads thread libraries (Linux kernel versions typically less than + 2.2) used these signals and made them unusable by the ERTS. + +* `erl_xcomp_poll` - `yes|no`. Defaults to `no` on Darwin/MacOSX; otherwise, + `yes`. If `yes`, the target system must have a working `poll()` + implementation that also can handle devices. If `no`, `select()` will be + used instead of `poll()`. + +* `erl_xcomp_putenv_copy` - `yes|no`. Defaults to `no`. If `yes`, the target + system must have a `putenv()` implementation that stores a copy of the + key/value pair. + +* `erl_xcomp_reliable_fpe` - `yes|no`. Defaults to `no`. If `yes`, the target + system must have reliable floating point exceptions. Copyright and License --------------------- @@ -470,16 +494,6 @@ Copyright and License > %CopyrightEnd% -<!-- - -Modifying This Document ------------------------ - -This document has been written using Markdown notation. This makes it possible -to easily generate a nice looking HTML version of this file. When modifying -this file, make sure that the modifications are made using valid Markdown -notation. For more information on Markdown see: - <http://daringfireball.net/projects/markdown/>. - ---> + [1]: ../INSTALL.html "$ERL_TOP/INSTALL.md" + [2]: http://www.gnu.org/prep/standards/html_node/DESTDIR.html "DESTDIR" diff --git a/xcomp/erl-xcomp-TileraMDE2.0-tilepro.conf b/xcomp/erl-xcomp-TileraMDE2.0-tilepro.conf index 9379739744..f9fff0fa8e 100644 --- a/xcomp/erl-xcomp-TileraMDE2.0-tilepro.conf +++ b/xcomp/erl-xcomp-TileraMDE2.0-tilepro.conf @@ -1,258 +1,258 @@ -#### -*-shell-script-*- -#### -#### %CopyrightBegin% -#### -#### Copyright Ericsson AB 2009-2010. All Rights Reserved. -#### -#### The contents of this file are subject to the Erlang Public License, -#### Version 1.1, (the "License"); you may not use this file except in -#### compliance with the License. You should have received a copy of the -#### Erlang Public License along with this software. If not, it can be -#### retrieved online at http://www.erlang.org/. -#### -#### Software distributed under the License is distributed on an "AS IS" -#### basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See -#### the License for the specific language governing rights and limitations -#### under the License. -#### -#### %CopyrightEnd% -#### -#### File: erl-xcomp-TileraMDE2.0-tilepro.conf -#### Author: Rickard Green -#### -#### -------------------------------------------------------------------------- -#### When cross compiling Erlang/OTP using `otp_build`, copy this file and set -#### the variables needed below. Then pass the path to the copy of this file as -#### an argument to `otp_build` in the configure stage: -#### `otp_build configure --xcomp-conf=<FILE>` -#### -------------------------------------------------------------------------- - -### Note that you cannot define arbitrary variables in a cross compilation -### configuration file. Only the ones listed below will be guaranteed to be -### visible throughout the whole execution of all `configure` scripts. Other -### variables needs to be defined as arguments to `configure` or exported in -### the environment. - -### ### Variables for `otp_build` Only ### - -### Variables in this section are only used, when configuring Erlang/OTP for -### cross compilation using `$ERL_TOP/otp_build configure`. - -### *NOTE*! These variables currently have *no* effect if you configure using -### the `configure` script directly. - -## `erl_xcomp_build` - The build system used. This value will be passed as -## `--build=$erl_xcomp_build` argument to the `configure` script. It does -## not have to be a full `CPU-VENDOR-OS` triplet, but can be. The full -## `CPU-VENDOR-OS` triplet will be created by -## `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build`. -## If set to `guess`, the build system will be guessed using -## `$ERL_TOP/erts/autoconf/config.guess`. +## -*-shell-script-*- +## +## %CopyrightBegin% +## +## Copyright Ericsson AB 2009-2010. All Rights Reserved. +## +## The contents of this file are subject to the Erlang Public License, +## Version 1.1, (the "License"); you may not use this file except in +## compliance with the License. You should have received a copy of the +## Erlang Public License along with this software. If not, it can be +## retrieved online at http://www.erlang.org/. +## +## Software distributed under the License is distributed on an "AS IS" +## basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See +## the License for the specific language governing rights and limitations +## under the License. +## +## %CopyrightEnd% +## +## File: erl-xcomp-TileraMDE2.0-tilepro.conf +## Author: Rickard Green +## +## ----------------------------------------------------------------------------- +## When cross compiling Erlang/OTP using `otp_build', copy this file and set +## the variables needed below. Then pass the path to the copy of this file as +## an argument to `otp_build' in the configure stage: +## `otp_build configure --xcomp-conf=<FILE>' +## ----------------------------------------------------------------------------- + +## Note that you cannot define arbitrary variables in a cross compilation +## configuration file. Only the ones listed below will be guaranteed to be +## visible throughout the whole execution of all `configure' scripts. Other +## variables needs to be defined as arguments to `configure' or exported in +## the environment. + +## -- Variables for `otp_build' Only ------------------------------------------- + +## Variables in this section are only used, when configuring Erlang/OTP for +## cross compilation using `$ERL_TOP/otp_build configure'. + +## *NOTE*! These variables currently have *no* effect if you configure using +## the `configure' script directly. + +# * `erl_xcomp_build' - The build system used. This value will be passed as +# `--build=$erl_xcomp_build' argument to the `configure' script. It does +# not have to be a full `CPU-VENDOR-OS' triplet, but can be. The full +# `CPU-VENDOR-OS' triplet will be created by +# `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build'. If set to `guess', +# the build system will be guessed using +# `$ERL_TOP/erts/autoconf/config.guess'. erl_xcomp_build=guess -## `erl_xcomp_host` - Cross host/target system to build for. This value will -## be passed as `--host=$erl_xcomp_host` argument to the `configure` script. -## It does not have to be a full `CPU-VENDOR-OS` triplet, but can be. The -## full `CPU-VENDOR-OS` triplet will be created by: -## `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host` +# * `erl_xcomp_host' - Cross host/target system to build for. This value will +# be passed as `--host=$erl_xcomp_host' argument to the `configure' script. +# It does not have to be a full `CPU-VENDOR-OS' triplet, but can be. The +# full `CPU-VENDOR-OS' triplet will be created by +# `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host'. erl_xcomp_host=tile -## `erl_xcomp_configure_flags` - Extra configure flags to pass to the -## `configure` script. +# * `erl_xcomp_configure_flags' - Extra configure flags to pass to the +# `configure' script. erl_xcomp_configure_flags="--without-termcap" -### ### Cross Compiler and Other Tools ### +## -- Cross Compiler and Other Tools ------------------------------------------- -### If the cross compilation tools are prefixed by `<HOST>-` you probably do -### not need to set these variables (where `<HOST>` is what has been passed as -### `--host=<HOST>` argument to `configure`). +## If the cross compilation tools are prefixed by `<HOST>-' you probably do +## not need to set these variables (where `<HOST>' is what has been passed as +## `--host=<HOST>' argument to `configure'). -### All variables in this section can also be used when native compiling. +## All variables in this section can also be used when native compiling. -## `CC` - C compiler. +# * `CC' - C compiler. #CC= -## `CFLAGS` - C compiler flags. +# * `CFLAGS' - C compiler flags. #CFLAGS= -## `STATIC_CFLAGS` - Static C compiler flags. +# * `STATIC_CFLAGS' - Static C compiler flags. #STATIC_CFLAGS= -## `CFLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library -## search path for the shared libraries. Note that this actually is a -## linker flag, but it needs to be passed via the compiler. +# * `CFLAG_RUNTIME_LIBRARY_PATH' - This flag should set runtime library +# search path for the shared libraries. Note that this actually is a +# linker flag, but it needs to be passed via the compiler. #CFLAG_RUNTIME_LIBRARY_PATH= -## `CPP` - C pre-processor. +# * `CPP' - C pre-processor. #CPP= -## `CPPFLAGS` - C pre-processor flags. +# * `CPPFLAGS' - C pre-processor flags. #CPPFLAGS= -## `CXX` - C++ compiler. +# * `CXX' - C++ compiler. #CXX= -## `CXXFLAGS` - C++ compiler flags. +# * `CXXFLAGS' - C++ compiler flags. #CXXFLAGS= -## `LD` - Linker. +# * `LD' - Linker. #LD= -## `LDFLAGS` - Linker flags. +# * `LDFLAGS' - Linker flags. #LDFLAGS= -## `LIBS` - Libraries. +# * `LIBS' - Libraries. #LIBS= -### #### *D*ynamic *E*rlang *D*river Linking #### +## -- *D*ynamic *E*rlang *D*river Linking -- -### *NOTE*! Either set all or none of the `DED_LD*` variables. +## *NOTE*! Either set all or none of the `DED_LD*' variables. -## `DED_LD` - Linker for Dynamically loaded Erlang Drivers. +# * `DED_LD' - Linker for Dynamically loaded Erlang Drivers. #DED_LD= -## `DED_LDFLAGS` - Linker flags to use with `DED_LD`. +# * `DED_LDFLAGS' - Linker flags to use with `DED_LD'. #DED_LDFLAGS= -## `DED_LD_FLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library -## search path for shared libraries when linking with `DED_LD`. +# * `DED_LD_FLAG_RUNTIME_LIBRARY_PATH' - This flag should set runtime library +# search path for shared libraries when linking with `DED_LD'. #DED_LD_FLAG_RUNTIME_LIBRARY_PATH= -### #### Large File Support #### +## -- Large File Support -- -### *NOTE*! Either set all or none of the `LFS_*` variables. +## *NOTE*! Either set all or none of the `LFS_*' variables. -## `LFS_CFLAGS` - Large file support C compiler flags. +# * `LFS_CFLAGS' - Large file support C compiler flags. #LFS_CFLAGS= -## `LFS_LDFLAGS` - Large file support linker flags. +# * `LFS_LDFLAGS' - Large file support linker flags. #LFS_LDFLAGS= -## `LFS_LIBS` - Large file support libraries. +# * `LFS_LIBS' - Large file support libraries. #LFS_LIBS= -### #### Other Tools #### +## -- Other Tools -- -## `RANLIB` - `ranlib` archive index tool. +# * `RANLIB' - `ranlib' archive index tool. #RANLIB= -## `AR` - `ar` archiving tool. +# * `AR' - `ar' archiving tool. #AR= -## `GETCONF` - `getconf` system configuration inspection tool. `getconf` is -## currently used for finding out large file support flags to use, and -## on Linux systems for finding out if we have an NPTL thread library or -## not. +# * `GETCONF' - `getconf' system configuration inspection tool. `getconf' is +# currently used for finding out large file support flags to use, and +# on Linux systems for finding out if we have an NPTL thread library or +# not. #GETCONF= -### ### Cross System Root Locations ### +## -- Cross System Root Locations ---------------------------------------------- -## `erl_xcomp_sysroot` - The absolute path to the system root of the cross -## compilation environment. Currently, the `crypto`, `odbc`, `ssh` and -## `ssl` applications need the system root. These applications will be -## skipped if the system root has not been set. The system root might be -## needed for other things too. If this is the case and the system root -## has not been set, `configure` will fail and request you to set it. +# * `erl_xcomp_sysroot' - The absolute path to the system root of the cross +# compilation environment. Currently, the `crypto', `odbc', `ssh' and +# `ssl' applications need the system root. These applications will be +# skipped if the system root has not been set. The system root might be +# needed for other things too. If this is the case and the system root +# has not been set, `configure' will fail and request you to set it. erl_xcomp_sysroot="$TILERA_ROOT/tile" -## `erl_xcomp_isysroot` - The absolute path to the system root for includes -## of the cross compilation environment. If not set, this value defaults -## to `$erl_xcomp_sysroot`, i.e., only set this value if the include system -## root path is not the same as the system root path. +# * `erl_xcomp_isysroot' - The absolute path to the system root for includes +# of the cross compilation environment. If not set, this value defaults +# to `$erl_xcomp_sysroot', i.e., only set this value if the include system +# root path is not the same as the system root path. #erl_xcomp_isysroot= -### ### Optional Feature, and Bug Tests ### +## -- Optional Feature, and Bug Tests ------------------------------------------ -### These tests cannot (always) be done automatically when cross compiling. You -### usually do not need to set these variables. Only set these if you really -### know what you are doing. +## These tests cannot (always) be done automatically when cross compiling. You +## usually do not need to set these variables. Only set these if you really +## know what you are doing. -### Note that some of these values will override results of tests performed -### by `configure`, and some will not be used until `configure` is sure that -### it cannot figure the result out. +## Note that some of these values will override results of tests performed +## by `configure', and some will not be used until `configure' is sure that +## it cannot figure the result out. -### The `configure` script will issue a warning when a default value is used. -### When a variable has been set, no warning will be issued. +## The `configure' script will issue a warning when a default value is used. +## When a variable has been set, no warning will be issued. -## `erl_xcomp_after_morecore_hook` - `yes|no`. Defaults to `no`. If `yes`, the -## target system must have a working `__after_morecore_hook` that can be -## used for tracking used `malloc()` implementations core memory usage. -## This is currently only used by unsupported features. +# * `erl_xcomp_after_morecore_hook' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `__after_morecore_hook' that can be +# used for tracking used `malloc()' implementations core memory usage. +# This is currently only used by unsupported features. #erl_xcomp_after_morecore_hook= -## `erl_xcomp_bigendian` - `yes|no`. No default. If `yes`, the target system -## must be big endian. If `no`, little endian. This can often be -## automatically detected, but not always. If not automatically detected, -## `configure` will fail unless this variable is set. Since no default -## value is used, `configure` will try to figure this out automatically. +# * `erl_xcomp_bigendian' - `yes|no'. No default. If `yes', the target system +# must be big endian. If `no', little endian. This can often be +# automatically detected, but not always. If not automatically detected, +# `configure' will fail unless this variable is set. Since no default +# value is used, `configure' will try to figure this out automatically. #erl_xcomp_bigendian= -## `erl_xcomp_clock_gettime_cpu_time` - `yes|no`. Defaults to `no`. If `yes`, -## the target system must have a working `clock_gettime()` implementation -## that can be used for retrieving process CPU time. +# * `erl_xcomp_clock_gettime_cpu_time' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `clock_gettime()' implementation +# that can be used for retrieving process CPU time. #erl_xcomp_clock_gettime_cpu_time= -## `erl_xcomp_getaddrinfo` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have a working `getaddrinfo()` implementation that can -## handle both IPv4 and IPv6. +# * `erl_xcomp_getaddrinfo' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a working `getaddrinfo()' implementation that can +# handle both IPv4 and IPv6. erl_xcomp_getaddrinfo=yes -## `erl_xcomp_gethrvtime_procfs_ioctl` - `yes|no`. Defaults to `no`. If `yes`, -## the target system must have a working `gethrvtime()` implementation and -## is used with procfs `ioctl()`. +# * `erl_xcomp_gethrvtime_procfs_ioctl' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `gethrvtime()' implementation and +# is used with procfs `ioctl()'. #erl_xcomp_gethrvtime_procfs_ioctl= -## `erl_xcomp_dlsym_brk_wrappers` - `yes|no`. Defaults to `no`. If `yes`, the -## target system must have a working `dlsym(RTLD_NEXT, <S>)` implementation -## that can be used on `brk` and `sbrk` symbols used by the `malloc()` -## implementation in use, and by this track the `malloc()` implementations -## core memory usage. This is currently only used by unsupported features. +# * `erl_xcomp_dlsym_brk_wrappers' - `yes|no'. Defaults to `no'. If `yes', the +# target system must have a working `dlsym(RTLD_NEXT, <S>)' implementation +# that can be used on `brk' and `sbrk' symbols used by the `malloc()' +# implementation in use, and by this track the `malloc()' implementations +# core memory usage. This is currently only used by unsupported features. #erl_xcomp_dlsym_brk_wrappers= -## `erl_xcomp_kqueue` - `yes|no`. Defaults to `no`. If `yes`, the target system -## must have a working `kqueue()` implementation that returns a file -## descriptor which can be used by `poll()` and/or `select()`. If `no` and -## the target system has not got `epoll()` or `/dev/poll`, the kernel-poll -## feature will be disabled. +# * `erl_xcomp_kqueue' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a working `kqueue()' implementation that returns a file +# descriptor which can be used by `poll()' and/or `select()'. If `no' and +# the target system has not got `epoll()' or `/dev/poll', the kernel-poll +# feature will be disabled. #erl_xcomp_kqueue= -## `erl_xcomp_linux_clock_gettime_correction` - `yes|no`. Defaults to `yes` on -## Linux; otherwise, `no`. If `yes`, `clock_gettime(CLOCK_MONOTONIC, _)` on -## the target system must work. This variable is recommended to be set to -## `no` on Linux systems with kernel versions less than 2.6. +# * `erl_xcomp_linux_clock_gettime_correction' - `yes|no'. Defaults to `yes' on +# Linux; otherwise, `no'. If `yes', `clock_gettime(CLOCK_MONOTONIC, _)' on +# the target system must work. This variable is recommended to be set to +# `no' on Linux systems with kernel versions less than 2.6. #erl_xcomp_linux_clock_gettime_correction= -## `erl_xcomp_linux_nptl` - `yes|no`. Defaults to `yes` on Linux; otherwise, -## `no`. If `yes`, the target system must have NPTL (Native POSIX Thread -## Library). Older Linux systems have LinuxThreads instead of NPTL (Linux -## kernel versions typically less than 2.6). +# * `erl_xcomp_linux_nptl' - `yes|no'. Defaults to `yes' on Linux; otherwise, +# `no'. If `yes', the target system must have NPTL (Native POSIX Thread +# Library). Older Linux systems have LinuxThreads instead of NPTL (Linux +# kernel versions typically less than 2.6). #erl_xcomp_linux_nptl= -## `erl_xcomp_linux_usable_sigaltstack` - `yes|no`. Defaults to `yes` on Linux; -## otherwise, `no`. If `yes`, `sigaltstack()` must be usable on the target -## system. `sigaltstack()` on Linux kernel versions less than 2.4 are -## broken. +# * `erl_xcomp_linux_usable_sigaltstack' - `yes|no'. Defaults to `yes' on Linux; +# otherwise, `no'. If `yes', `sigaltstack()' must be usable on the target +# system. `sigaltstack()' on Linux kernel versions less than 2.4 are +# broken. #erl_xcomp_linux_usable_sigaltstack= -## `erl_xcomp_linux_usable_sigusrx` - `yes|no`. Defaults to `yes`. If `yes`, -## the `SIGUSR1` and `SIGUSR2` signals must be usable by the ERTS. Old -## LinuxThreads thread libraries (Linux kernel versions typically less than -## 2.2) used these signals and made them unusable by the ERTS. +# * `erl_xcomp_linux_usable_sigusrx' - `yes|no'. Defaults to `yes'. If `yes', +# the `SIGUSR1' and `SIGUSR2' signals must be usable by the ERTS. Old +# LinuxThreads thread libraries (Linux kernel versions typically less than +# 2.2) used these signals and made them unusable by the ERTS. #erl_xcomp_linux_usable_sigusrx= -## `erl_xcomp_poll` - `yes|no`. Defaults to `no` on Darwin/MacOSX; otherwise, -## `yes`. If `yes`, the target system must have a working `poll()` -## implementation that also can handle devices. If `no`, `select()` will be -## used instead of `poll()`. +# * `erl_xcomp_poll' - `yes|no'. Defaults to `no' on Darwin/MacOSX; otherwise, +# `yes'. If `yes', the target system must have a working `poll()' +# implementation that also can handle devices. If `no', `select()' will be +# used instead of `poll()'. #erl_xcomp_poll= -## `erl_xcomp_putenv_copy` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have a `putenv()` implementation that stores a copy of the -## key/value pair. +# * `erl_xcomp_putenv_copy' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a `putenv()' implementation that stores a copy of the +# key/value pair. #erl_xcomp_putenv_copy= -## `erl_xcomp_reliable_fpe` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have reliable floating point exceptions. +# * `erl_xcomp_reliable_fpe' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have reliable floating point exceptions. #erl_xcomp_reliable_fpe= -#### +## ----------------------------------------------------------------------------- diff --git a/xcomp/erl-xcomp-avr32-atmel-linux-gnu.conf b/xcomp/erl-xcomp-avr32-atmel-linux-gnu.conf index 11ffce2085..f691c6cfd1 100644 --- a/xcomp/erl-xcomp-avr32-atmel-linux-gnu.conf +++ b/xcomp/erl-xcomp-avr32-atmel-linux-gnu.conf @@ -1,262 +1,261 @@ -#### -*-shell-script-*- -#### -#### %CopyrightBegin% -#### -#### Copyright Ericsson AB 2010. All Rights Reserved. -#### -#### The contents of this file are subject to the Erlang Public License, -#### Version 1.1, (the "License"); you may not use this file except in -#### compliance with the License. You should have received a copy of the -#### Erlang Public License along with this software. If not, it can be -#### retrieved online at http://www.erlang.org/. -#### -#### Software distributed under the License is distributed on an "AS IS" -#### basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See -#### the License for the specific language governing rights and limitations -#### under the License. -#### -#### %CopyrightEnd% -#### -#### File: erl-xcomp-avr32-atmel-linux-gnu.conf -#### Author: Winston Smith <[email protected]> -#### -#### -------------------------------------------------------------------------- -#### When cross compiling Erlang/OTP using `otp_build', copy this file and set -#### the variables needed below. Then pass the path to the copy of this file as -#### an argument to `otp_build' in the configure stage: -#### `otp_build configure --xcomp-conf=<FILE>' -#### -------------------------------------------------------------------------- - -### Note that you cannot define arbitrary variables in a cross compilation -### configuration file. Only the ones listed below will be guaranteed to be -### visible throughout the whole execution of all `configure' scripts. Other -### variables needs to be defined as arguments to `configure' or exported in -### the environment. - -### ---- `otp_build' only variables ------------------------------------------- - -### Variables in this section are only used, when configuring Erlang/OTP for -### cross compilation using `$ERL_TOP/otp_build configure'. - -### NOTE! These variables currently have *no* effect if you configure using the -### `configure' script directly. - -## erl_xcomp_build - Build system. -## This value will be passed as `--build=$erl_xcomp_build' argument to the -## `configure' script. It does not have to be a full CPU-VENDOR-OS triplet, -## but can be. The full CPU-VENDOR-OS triplet will be created by: -## `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build' -## If `erl_xcomp_build=guess', the build system will be guessed using: -## `$ERL_TOP/erts/autoconf/config.guess'. +## -*-shell-script-*- +## +## %CopyrightBegin% +## +## Copyright Ericsson AB 2010. All Rights Reserved. +## +## The contents of this file are subject to the Erlang Public License, +## Version 1.1, (the "License"); you may not use this file except in +## compliance with the License. You should have received a copy of the +## Erlang Public License along with this software. If not, it can be +## retrieved online at http://www.erlang.org/. +## +## Software distributed under the License is distributed on an "AS IS" +## basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See +## the License for the specific language governing rights and limitations +## under the License. +## +## %CopyrightEnd% +## +## File: erl-xcomp-avr32-atmel-linux-gnu.conf +## Author: Winston Smith <[email protected]> +## +## ----------------------------------------------------------------------------- +## When cross compiling Erlang/OTP using `otp_build', copy this file and set +## the variables needed below. Then pass the path to the copy of this file as +## an argument to `otp_build' in the configure stage: +## `otp_build configure --xcomp-conf=<FILE>' +## ----------------------------------------------------------------------------- + +## Note that you cannot define arbitrary variables in a cross compilation +## configuration file. Only the ones listed below will be guaranteed to be +## visible throughout the whole execution of all `configure' scripts. Other +## variables needs to be defined as arguments to `configure' or exported in +## the environment. + +## -- Variables for `otp_build' Only ------------------------------------------- + +## Variables in this section are only used, when configuring Erlang/OTP for +## cross compilation using `$ERL_TOP/otp_build configure'. + +## *NOTE*! These variables currently have *no* effect if you configure using +## the `configure' script directly. + +# * `erl_xcomp_build' - The build system used. This value will be passed as +# `--build=$erl_xcomp_build' argument to the `configure' script. It does +# not have to be a full `CPU-VENDOR-OS' triplet, but can be. The full +# `CPU-VENDOR-OS' triplet will be created by +# `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build'. If set to `guess', +# the build system will be guessed using +# `$ERL_TOP/erts/autoconf/config.guess'. erl_xcomp_build=guess -## erl_xcomp_host - Cross host system. -## This value will be passed as `--host=$erl_xcomp_host' argument to the -## `configure' script. It does not have to be a full CPU-VENDOR-OS triplet, -## but can be. The full CPU-VENDOR-OS triplet will be created by: -## `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host' +# * `erl_xcomp_host' - Cross host/target system to build for. This value will +# be passed as `--host=$erl_xcomp_host' argument to the `configure' script. +# It does not have to be a full `CPU-VENDOR-OS' triplet, but can be. The +# full `CPU-VENDOR-OS' triplet will be created by +# `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host'. erl_xcomp_host=avr32-atmel-linux-gnu -## erl_xcomp_configure_flags - Extra configure flags. -## Extra flags to pass to the `configure' script. +# * `erl_xcomp_configure_flags' - Extra configure flags to pass to the +# `configure' script. #erl_xcomp_configure_flags= -### ---- Cross compiler and other tools to use -------------------------------- +## -- Cross Compiler and Other Tools ------------------------------------------- -### If the cross compilation tools are prefixed by `<HOST>-' you probably do -### not need to set these variables (where `<HOST>' is what has been passed as -### `--host=<HOST>' argument to `configure'). +## If the cross compilation tools are prefixed by `<HOST>-' you probably do +## not need to set these variables (where `<HOST>' is what has been passed as +## `--host=<HOST>' argument to `configure'). -## CC - C compiler. +## All variables in this section can also be used when native compiling. + +# * `CC' - C compiler. CC=avr32-linux-gcc -## CFLAGS - C compiler flags. +# * `CFLAGS' - C compiler flags. #CFLAGS= -## STATIC_CFLAGS - Static C compiler flags. +# * `STATIC_CFLAGS' - Static C compiler flags. #STATIC_CFLAGS= -## CFLAG_RUNTIME_LIBRARY_PATH - C compiler runtime library path flag. -## This flag should set a specific runtime library path for the shared -## library at link time. Note that this is actually a linker flag, but it -## needs to be passed via the compiler. +# * `CFLAG_RUNTIME_LIBRARY_PATH' - This flag should set runtime library +# search path for the shared libraries. Note that this actually is a +# linker flag, but it needs to be passed via the compiler. #CFLAG_RUNTIME_LIBRARY_PATH= -## CPP - C pre-processor. +# * `CPP' - C pre-processor. #CPP= -## CPPFLAGS - C pre-processor flags. +# * `CPPFLAGS' - C pre-processor flags. #CPPFLAGS= -## CXX - C++ compiler. +# * `CXX' - C++ compiler. CXX=avr32-linux-g++ -## CXXFLAGS - C++ compiler flags. +# * `CXXFLAGS' - C++ compiler flags. #CXXFLAGS= -## LD - Linker. +# * `LD' - Linker. LD=avr32-linux-ld -## LDFLAGS - Linker flags. +# * `LDFLAGS' - Linker flags. #LDFLAGS= -## LIBS - Libraries. +# * `LIBS' - Libraries. #LIBS= -### -- Dynamic Erlang Driver linker flags -- +## -- *D*ynamic *E*rlang *D*river Linking -- -### NOTE! Either set all or non of the DED_LD* variables. +## *NOTE*! Either set all or none of the `DED_LD*' variables. -## DED_LD - Linker. +# * `DED_LD' - Linker for Dynamically loaded Erlang Drivers. #DED_LD= -## DED_LDFLAGS - Linker flags. +# * `DED_LDFLAGS' - Linker flags to use with `DED_LD'. #DED_LDFLAGS= -## DED_LD_FLAG_RUNTIME_LIBRARY_PATH - Linker runtime library path flag. -## This flag should set a specific runtime library path for the shared -## library at link time. +# * `DED_LD_FLAG_RUNTIME_LIBRARY_PATH' - This flag should set runtime library +# search path for shared libraries when linking with `DED_LD'. #DED_LD_FLAG_RUNTIME_LIBRARY_PATH= -### -- Large file support -- +## -- Large File Support -- -### NOTE! Either set all or non of the LFS_* variables. +## *NOTE*! Either set all or none of the `LFS_*' variables. -## LFS_CFLAGS - Large file support C compiler flags. +# * `LFS_CFLAGS' - Large file support C compiler flags. #LFS_CFLAGS= -## LFS_LDFLAGS - Large file support linker flags. +# * `LFS_LDFLAGS' - Large file support linker flags. #LFS_LDFLAGS= -## LFS_LIBS - Large file support libraries. +# * `LFS_LIBS' - Large file support libraries. #LFS_LIBS= -### -- Other tools -- +## -- Other Tools -- -## RANLIB - `ranlib' archive index tool. +# * `RANLIB' - `ranlib' archive index tool. RANLIB=avr32-linux-ranlib -## AR - `ar' archiving tool. +# * `AR' - `ar' archiving tool. AR=avr32-linux-ar -## GETCONF - `getconf' system configuration inspection tool. +# * `GETCONF' - `getconf' system configuration inspection tool. `getconf' is +# currently used for finding out large file support flags to use, and +# on Linux systems for finding out if we have an NPTL thread library or +# not. #GETCONF= -### ---- Cross System Root Locations ------------------------------------------ - -## erl_xcomp_sysroot - Absolute cross system root path. -## The absolute path to the system root of the cross compilation -## environment. Currently, the `crypto', `odbc', `ssh' and `ssl' -## applications need the system root. These applications will be skipped -## if the system root has not been set. The system root might be needed -## for other things too. If this is the case and the system root has not -## been set, `configure' will fail and request you to set it. -## -## NOTE: For AVR32, this should be set to the build_avr32/staging_dir -## subdirectory within the buildroot tree. +## -- Cross System Root Locations ---------------------------------------------- + +# * `erl_xcomp_sysroot' - The absolute path to the system root of the cross +# compilation environment. Currently, the `crypto', `odbc', `ssh' and +# `ssl' applications need the system root. These applications will be +# skipped if the system root has not been set. The system root might be +# needed for other things too. If this is the case and the system root +# has not been set, `configure' will fail and request you to set it. +# +# NOTE: For AVR32, this should be set to the build_avr32/staging_dir +# subdirectory within the buildroot tree. erl_xcomp_sysroot="$ATMEL_SYSROOT_AVR32" -## erl_xcomp_isysroot - Absolute cross include system root path. -## The absolute path to the system root for includes of the cross -## compilation environment. If not set, this value defaults to -## `$erl_xcomp_sysroot', i.e., only set this value if the include system -## root path is not the same as the system root path. +# * `erl_xcomp_isysroot' - The absolute path to the system root for includes +# of the cross compilation environment. If not set, this value defaults +# to `$erl_xcomp_sysroot', i.e., only set this value if the include system +# root path is not the same as the system root path. #erl_xcomp_isysroot= -### ---- Optional feature, or bug tests --------------------------------------- +## -- Optional Feature, and Bug Tests ------------------------------------------ -### These tests cannot (always) be done automatically when cross compiling. You -### usually does not need to set these variables. Only set these if you really -### know what you are doing. +## These tests cannot (always) be done automatically when cross compiling. You +## usually do not need to set these variables. Only set these if you really +## know what you are doing. -### Note that some of these values will override results of tests performed -### by `configure', and some will not be used until `configure' is sure that -### it cannot figure the result out. +## Note that some of these values will override results of tests performed +## by `configure', and some will not be used until `configure' is sure that +## it cannot figure the result out. -### The `configure' script will issue a warning when a default value is used. -### When a variable has been set, no warning will be issued. +## The `configure' script will issue a warning when a default value is used. +## When a variable has been set, no warning will be issued. -## erl_xcomp_bigendian - yes|no -## If `yes', the target system must be big endian. If `no', little endian. -## This can often be automatically detected, but not always. If not -## automatically detected, `configure' will fail unless this variable is -## set. No default value is used, i.e., `configure' will try to figure -## this out automatically. -#erl_xcomp_bigendian= +# * `erl_xcomp_after_morecore_hook' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `__after_morecore_hook' that can be +# used for tracking used `malloc()' implementations core memory usage. +# This is currently only used by unsupported features. +#erl_xcomp_after_morecore_hook= -## erl_xcomp_linux_clock_gettime_correction - yes|no (defaults to `yes' on -## Linux; otherwise, `no') -## If `yes', `clock_gettime(CLOCK_MONOTONIC, _)' on the target system must -## work. This variable is recommended to be set to `no' on Linux systems -## with kernel versions less than 2.6. -#erl_xcomp_linux_clock_gettime_correction= +# * `erl_xcomp_bigendian' - `yes|no'. No default. If `yes', the target system +# must be big endian. If `no', little endian. This can often be +# automatically detected, but not always. If not automatically detected, +# `configure' will fail unless this variable is set. Since no default +# value is used, `configure' will try to figure this out automatically. +#erl_xcomp_bigendian= -## erl_xcomp_linux_nptl - yes|no (defaults to `yes' on Linux; otherwise, `no') -## If `yes', the target system must have NPTL (Native POSIX Thread Library). -## Older Linux systems have LinuxThreads instead of NPTL (Linux kernel -## versions typically less than 2.6). -#erl_xcomp_linux_nptl= +# * `erl_xcomp_clock_gettime_cpu_time' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `clock_gettime()' implementation +# that can be used for retrieving process CPU time. +erl_xcomp_clock_gettime_cpu_time=yes -## erl_xcomp_linux_usable_sigusrx - yes|no (defaults to `yes') -## If `yes', the `SIGUSR1' and `SIGUSR2' signals must be usable by the ERTS. -## Old LinuxThreads thread libraries (Linux kernel versions less than 2.2) -## used these signals and made them unusable by the ERTS. -#erl_xcomp_linux_usable_sigusrx= +# * `erl_xcomp_getaddrinfo' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a working `getaddrinfo()' implementation that can +# handle both IPv4 and IPv6. +erl_xcomp_getaddrinfo=yes -## erl_xcomp_linux_usable_sigaltstack - yes|no (defaults to `yes' on Linux; -## otherwise, `no') -## If `yes', `sigaltstack()' must be usable on the target system. -## `sigaltstack()' on Linux kernel versions less than 2.4 are broken. -#erl_xcomp_linux_usable_sigaltstack= +# * `erl_xcomp_gethrvtime_procfs_ioctl' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `gethrvtime()' implementation and +# is used with procfs `ioctl()'. +#erl_xcomp_gethrvtime_procfs_ioctl= -## erl_xcomp_poll - yes|no (defaults to `no' on Darwin/MacOSX; otherwise, `yes') -## If `yes', the target system must have a working `poll()' implementation -## that also can handle devices. If `no', `select()' will be used instead of -## `poll()'. -#erl_xcomp_poll= +# * `erl_xcomp_dlsym_brk_wrappers' - `yes|no'. Defaults to `no'. If `yes', the +# target system must have a working `dlsym(RTLD_NEXT, <S>)' implementation +# that can be used on `brk' and `sbrk' symbols used by the `malloc()' +# implementation in use, and by this track the `malloc()' implementations +# core memory usage. This is currently only used by unsupported features. +erl_xcomp_dlsym_brk_wrappers=yes -## erl_xcomp_kqueue - yes|no (defaults to `no') -## If `yes', the target system must have a working `kqueue()' implementation -## that returns a file descriptor which can be used by `poll()' and/or -## `select()'. If `no' and the target system has not got `epoll()' or -## `/dev/poll', the kernel-poll feature will be disabled. +# * `erl_xcomp_kqueue' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a working `kqueue()' implementation that returns a file +# descriptor which can be used by `poll()' and/or `select()'. If `no' and +# the target system has not got `epoll()' or `/dev/poll', the kernel-poll +# feature will be disabled. #erl_xcomp_kqueue= -## erl_xcomp_putenv_copy - yes|no (defaults to `no') -## If `yes', the target system must have a `putenv()' implementation that -## stores a copy of the key/value pair. -#erl_xcomp_putenv_copy= +# * `erl_xcomp_linux_clock_gettime_correction' - `yes|no'. Defaults to `yes' on +# Linux; otherwise, `no'. If `yes', `clock_gettime(CLOCK_MONOTONIC, _)' on +# the target system must work. This variable is recommended to be set to +# `no' on Linux systems with kernel versions less than 2.6. +#erl_xcomp_linux_clock_gettime_correction= -## erl_xcomp_reliable_fpe - yes|no (defaults to `no') -## If `yes', the target system must have reliable floating point exceptions. -#erl_xcomp_reliable_fpe= +# * `erl_xcomp_linux_nptl' - `yes|no'. Defaults to `yes' on Linux; otherwise, +# `no'. If `yes', the target system must have NPTL (Native POSIX Thread +# Library). Older Linux systems have LinuxThreads instead of NPTL (Linux +# kernel versions typically less than 2.6). +#erl_xcomp_linux_nptl= -## erl_xcomp_getaddrinfo - yes|no (defaults to `no') -## If `yes', the target system must have a working `getaddrinfo()' -## implementation that can handle both IPv4 and IPv6. -erl_xcomp_getaddrinfo=yes +# * `erl_xcomp_linux_usable_sigaltstack' - `yes|no'. Defaults to `yes' on Linux; +# otherwise, `no'. If `yes', `sigaltstack()' must be usable on the target +# system. `sigaltstack()' on Linux kernel versions less than 2.4 are +# broken. +#erl_xcomp_linux_usable_sigaltstack= -## erl_xcomp_gethrvtime_procfs_ioctl - yes|no (defaults to `no') -## If `yes', the target system must have a working `gethrvtime()' -## implementation and is used with procfs `ioctl()'. -#erl_xcomp_gethrvtime_procfs_ioctl= +# * `erl_xcomp_linux_usable_sigusrx' - `yes|no'. Defaults to `yes'. If `yes', +# the `SIGUSR1' and `SIGUSR2' signals must be usable by the ERTS. Old +# LinuxThreads thread libraries (Linux kernel versions typically less than +# 2.2) used these signals and made them unusable by the ERTS. +#erl_xcomp_linux_usable_sigusrx= -## erl_xcomp_clock_gettime_cpu_time - yes|no (defaults to `no') -## If `yes', the target system must have a working `clock_gettime()' -## implementation that can be used for retrieving process CPU time. -erl_xcomp_clock_gettime_cpu_time=yes +# * `erl_xcomp_poll' - `yes|no'. Defaults to `no' on Darwin/MacOSX; otherwise, +# `yes'. If `yes', the target system must have a working `poll()' +# implementation that also can handle devices. If `no', `select()' will be +# used instead of `poll()'. +#erl_xcomp_poll= -## erl_xcomp_after_morecore_hook - yes|no (defaults to `no') -## If `yes', the target system must have a working `__after_morecore_hook' -## that can be used for tracking used `malloc()' implementations core memory -## usage. -#erl_xcomp_after_morecore_hook= +# * `erl_xcomp_putenv_copy' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a `putenv()' implementation that stores a copy of the +# key/value pair. +#erl_xcomp_putenv_copy= -## erl_xcomp_dlsym_brk_wrappers - yes|no (defaults to `no') -## If `yes', the target system must have a working `dlsym(RTLD_NEXT, <S>)' -## implementation that can be used on `brk' and `sbrk' symbols used by the -## `malloc()' implementation in use, and by this track the `malloc()' -## implementations core memory usage. -erl_xcomp_dlsym_brk_wrappers=yes +# * `erl_xcomp_reliable_fpe' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have reliable floating point exceptions. +#erl_xcomp_reliable_fpe= -#### -------------------------------------------------------------------------- +## ----------------------------------------------------------------------------- diff --git a/xcomp/erl-xcomp-vxworks_ppc32.conf b/xcomp/erl-xcomp-vxworks_ppc32.conf index b75c7444bb..ed8305ea93 100644 --- a/xcomp/erl-xcomp-vxworks_ppc32.conf +++ b/xcomp/erl-xcomp-vxworks_ppc32.conf @@ -1,258 +1,258 @@ -#### -*-shell-script-*- -#### -#### %CopyrightBegin% -#### -#### Copyright Ericsson AB 2009-2010. All Rights Reserved. -#### -#### The contents of this file are subject to the Erlang Public License, -#### Version 1.1, (the "License"); you may not use this file except in -#### compliance with the License. You should have received a copy of the -#### Erlang Public License along with this software. If not, it can be -#### retrieved online at http://www.erlang.org/. -#### -#### Software distributed under the License is distributed on an "AS IS" -#### basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See -#### the License for the specific language governing rights and limitations -#### under the License. -#### -#### %CopyrightEnd% -#### -#### File: erl-xcomp-vxworks_ppc32.conf -#### Author: Rickard Green/Patrik Nyblom -#### -#### -------------------------------------------------------------------------- -#### When cross compiling Erlang/OTP using `otp_build`, copy this file and set -#### the variables needed below. Then pass the path to the copy of this file as -#### an argument to `otp_build` in the configure stage: -#### `otp_build configure --xcomp-conf=<FILE>` -#### -------------------------------------------------------------------------- - -### Note that you cannot define arbitrary variables in a cross compilation -### configuration file. Only the ones listed below will be guaranteed to be -### visible throughout the whole execution of all `configure` scripts. Other -### variables needs to be defined as arguments to `configure` or exported in -### the environment. - -### ### Variables for `otp_build` Only ### - -### Variables in this section are only used, when configuring Erlang/OTP for -### cross compilation using `$ERL_TOP/otp_build configure`. - -### *NOTE*! These variables currently have *no* effect if you configure using -### the `configure` script directly. - -## `erl_xcomp_build` - The build system used. This value will be passed as -## `--build=$erl_xcomp_build` argument to the `configure` script. It does -## not have to be a full `CPU-VENDOR-OS` triplet, but can be. The full -## `CPU-VENDOR-OS` triplet will be created by -## `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build`. -## If set to `guess`, the build system will be guessed using -## `$ERL_TOP/erts/autoconf/config.guess`. +## -*-shell-script-*- +## +## %CopyrightBegin% +## +## Copyright Ericsson AB 2009-2010. All Rights Reserved. +## +## The contents of this file are subject to the Erlang Public License, +## Version 1.1, (the "License"); you may not use this file except in +## compliance with the License. You should have received a copy of the +## Erlang Public License along with this software. If not, it can be +## retrieved online at http://www.erlang.org/. +## +## Software distributed under the License is distributed on an "AS IS" +## basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See +## the License for the specific language governing rights and limitations +## under the License. +## +## %CopyrightEnd% +## +## File: erl-xcomp-vxworks_ppc32.conf +## Author: Rickard Green/Patrik Nyblom +## +## ----------------------------------------------------------------------------- +## When cross compiling Erlang/OTP using `otp_build', copy this file and set +## the variables needed below. Then pass the path to the copy of this file as +## an argument to `otp_build' in the configure stage: +## `otp_build configure --xcomp-conf=<FILE>' +## ----------------------------------------------------------------------------- + +## Note that you cannot define arbitrary variables in a cross compilation +## configuration file. Only the ones listed below will be guaranteed to be +## visible throughout the whole execution of all `configure' scripts. Other +## variables needs to be defined as arguments to `configure' or exported in +## the environment. + +## -- Variables for `otp_build' Only ------------------------------------------- + +## Variables in this section are only used, when configuring Erlang/OTP for +## cross compilation using `$ERL_TOP/otp_build configure'. + +## *NOTE*! These variables currently have *no* effect if you configure using +## the `configure' script directly. + +# * `erl_xcomp_build' - The build system used. This value will be passed as +# `--build=$erl_xcomp_build' argument to the `configure' script. It does +# not have to be a full `CPU-VENDOR-OS' triplet, but can be. The full +# `CPU-VENDOR-OS' triplet will be created by +# `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build'. If set to `guess', +# the build system will be guessed using +# `$ERL_TOP/erts/autoconf/config.guess'. erl_xcomp_build=guess -## `erl_xcomp_host` - Cross host/target system to build for. This value will -## be passed as `--host=$erl_xcomp_host` argument to the `configure` script. -## It does not have to be a full `CPU-VENDOR-OS` triplet, but can be. The -## full `CPU-VENDOR-OS` triplet will be created by: -## `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host` +# * `erl_xcomp_host' - Cross host/target system to build for. This value will +# be passed as `--host=$erl_xcomp_host' argument to the `configure' script. +# It does not have to be a full `CPU-VENDOR-OS' triplet, but can be. The +# full `CPU-VENDOR-OS' triplet will be created by +# `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host'. erl_xcomp_host=powerpc-wrs-vxworks -## `erl_xcomp_configure_flags` - Extra configure flags to pass to the -## `configure` script. +# * `erl_xcomp_configure_flags' - Extra configure flags to pass to the +# `configure' script. erl_xcomp_configure_flags="--disable-threads --without-termcap" -### ### Cross Compiler and Other Tools ### +## -- Cross Compiler and Other Tools ------------------------------------------- -### If the cross compilation tools are prefixed by `<HOST>-` you probably do -### not need to set these variables (where `<HOST>` is what has been passed as -### `--host=<HOST>` argument to `configure`). +## If the cross compilation tools are prefixed by `<HOST>-' you probably do +## not need to set these variables (where `<HOST>' is what has been passed as +## `--host=<HOST>' argument to `configure'). -### All variables in this section can also be used when native compiling. +## All variables in this section can also be used when native compiling. -## `CC` - C compiler. +# * `CC' - C compiler. CC="$WIND_BASE/gnu/3.4.4-vxworks-6.3/$WIND_HOST_TYPE/bin/ccppc" -## `CFLAGS` - C compiler flags. +# * `CFLAGS' - C compiler flags. CFLAGS="-DCPU=PPC32 -DTOOL_FAMILY=gnu -DTOOL=gnu -DWANT_NONBLOCKING -DHAVE_SENS -DHAVE_MEMMOVE -DVXWORKS -I$WIND_BASE/vxworks-6.3/target/h -I$WIND_BASE/gnu/3.4.4-vxworks-6.3/$WIND_HOST_TYPE/lib/gcc/powerpc-wrs-vxworks/3.4.4/include -I$WIND_BASE/vxworks-6.3/target/h/wrn/coreip -I$WIND_BASE/vxworks-6.3/target/h -mstrict-align -fvolatile -fno-builtin -mlongcall" -## `STATIC_CFLAGS` - Static C compiler flags. +# * `STATIC_CFLAGS' - Static C compiler flags. #STATIC_CFLAGS= -## `CFLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library -## search path for the shared libraries. Note that this actually is a -## linker flag, but it needs to be passed via the compiler. +# * `CFLAG_RUNTIME_LIBRARY_PATH' - This flag should set runtime library +# search path for the shared libraries. Note that this actually is a +# linker flag, but it needs to be passed via the compiler. #CFLAG_RUNTIME_LIBRARY_PATH= -## `CPP` - C pre-processor. +# * `CPP' - C pre-processor. CPP="$CC $CFLAGS -E" -## `CPPFLAGS` - C pre-processor flags. +# * `CPPFLAGS' - C pre-processor flags. #CPPFLAGS= -## `CXX` - C++ compiler. +# * `CXX' - C++ compiler. #CXX= -## `CXXFLAGS` - C++ compiler flags. +# * `CXXFLAGS' - C++ compiler flags. #CXXFLAGS= -## `LD` - Linker. +# * `LD' - Linker. LD="$WIND_BASE/gnu/3.4.4-vxworks-6.3/$WIND_HOST_TYPE/bin/ldppc" -## `LDFLAGS` - Linker flags. +# * `LDFLAGS' - Linker flags. LDFLAGS="-mlongcall" -## `LIBS` - Libraries. +# * `LIBS' - Libraries. #LIBS= -### #### *D*ynamic *E*rlang *D*river Linking #### +## -- *D*ynamic *E*rlang *D*river Linking -- -### *NOTE*! Either set all or none of the `DED_LD*` variables. +## *NOTE*! Either set all or none of the `DED_LD*' variables. -## `DED_LD` - Linker for Dynamically loaded Erlang Drivers. +# * `DED_LD' - Linker for Dynamically loaded Erlang Drivers. #DED_LD= -## `DED_LDFLAGS` - Linker flags to use with `DED_LD`. +# * `DED_LDFLAGS' - Linker flags to use with `DED_LD'. #DED_LDFLAGS= -## `DED_LD_FLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library -## search path for shared libraries when linking with `DED_LD`. +# * `DED_LD_FLAG_RUNTIME_LIBRARY_PATH' - This flag should set runtime library +# search path for shared libraries when linking with `DED_LD'. #DED_LD_FLAG_RUNTIME_LIBRARY_PATH= -### #### Large File Support #### +## -- Large File Support -- -### *NOTE*! Either set all or none of the `LFS_*` variables. +## *NOTE*! Either set all or none of the `LFS_*' variables. -## `LFS_CFLAGS` - Large file support C compiler flags. +# * `LFS_CFLAGS' - Large file support C compiler flags. #LFS_CFLAGS= -## `LFS_LDFLAGS` - Large file support linker flags. +# * `LFS_LDFLAGS' - Large file support linker flags. #LFS_LDFLAGS= -## `LFS_LIBS` - Large file support libraries. +# * `LFS_LIBS' - Large file support libraries. #LFS_LIBS= -### #### Other Tools #### +## -- Other Tools -- -## `RANLIB` - `ranlib` archive index tool. +# * `RANLIB' - `ranlib' archive index tool. RANLIB="$WIND_BASE/gnu/3.4.4-vxworks-6.3/$WIND_HOST_TYPE/bin/ranlibppc" -## `AR` - `ar` archiving tool. +# * `AR' - `ar' archiving tool. AR="$WIND_BASE/gnu/3.4.4-vxworks-6.3/$WIND_HOST_TYPE/bin/arppc" -## `GETCONF` - `getconf` system configuration inspection tool. `getconf` is -## currently used for finding out large file support flags to use, and -## on Linux systems for finding out if we have an NPTL thread library or -## not. +# * `GETCONF' - `getconf' system configuration inspection tool. `getconf' is +# currently used for finding out large file support flags to use, and +# on Linux systems for finding out if we have an NPTL thread library or +# not. #GETCONF= -### ### Cross System Root Locations ### +## -- Cross System Root Locations ---------------------------------------------- -## `erl_xcomp_sysroot` - The absolute path to the system root of the cross -## compilation environment. Currently, the `crypto`, `odbc`, `ssh` and -## `ssl` applications need the system root. These applications will be -## skipped if the system root has not been set. The system root might be -## needed for other things too. If this is the case and the system root -## has not been set, `configure` will fail and request you to set it. +# * `erl_xcomp_sysroot' - The absolute path to the system root of the cross +# compilation environment. Currently, the `crypto', `odbc', `ssh' and +# `ssl' applications need the system root. These applications will be +# skipped if the system root has not been set. The system root might be +# needed for other things too. If this is the case and the system root +# has not been set, `configure' will fail and request you to set it. #erl_xcomp_sysroot= -## `erl_xcomp_isysroot` - The absolute path to the system root for includes -## of the cross compilation environment. If not set, this value defaults -## to `$erl_xcomp_sysroot`, i.e., only set this value if the include system -## root path is not the same as the system root path. +# * `erl_xcomp_isysroot' - The absolute path to the system root for includes +# of the cross compilation environment. If not set, this value defaults +# to `$erl_xcomp_sysroot', i.e., only set this value if the include system +# root path is not the same as the system root path. #erl_xcomp_isysroot= -### ### Optional Feature, and Bug Tests ### +## -- Optional Feature, and Bug Tests ------------------------------------------ -### These tests cannot (always) be done automatically when cross compiling. You -### usually do not need to set these variables. Only set these if you really -### know what you are doing. +## These tests cannot (always) be done automatically when cross compiling. You +## usually do not need to set these variables. Only set these if you really +## know what you are doing. -### Note that some of these values will override results of tests performed -### by `configure`, and some will not be used until `configure` is sure that -### it cannot figure the result out. +## Note that some of these values will override results of tests performed +## by `configure', and some will not be used until `configure' is sure that +## it cannot figure the result out. -### The `configure` script will issue a warning when a default value is used. -### When a variable has been set, no warning will be issued. +## The `configure' script will issue a warning when a default value is used. +## When a variable has been set, no warning will be issued. -## `erl_xcomp_after_morecore_hook` - `yes|no`. Defaults to `no`. If `yes`, the -## target system must have a working `__after_morecore_hook` that can be -## used for tracking used `malloc()` implementations core memory usage. -## This is currently only used by unsupported features. +# * `erl_xcomp_after_morecore_hook' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `__after_morecore_hook' that can be +# used for tracking used `malloc()' implementations core memory usage. +# This is currently only used by unsupported features. #erl_xcomp_after_morecore_hook= -## `erl_xcomp_bigendian` - `yes|no`. No default. If `yes`, the target system -## must be big endian. If `no`, little endian. This can often be -## automatically detected, but not always. If not automatically detected, -## `configure` will fail unless this variable is set. Since no default -## value is used, `configure` will try to figure this out automatically. +# * `erl_xcomp_bigendian' - `yes|no'. No default. If `yes', the target system +# must be big endian. If `no', little endian. This can often be +# automatically detected, but not always. If not automatically detected, +# `configure' will fail unless this variable is set. Since no default +# value is used, `configure' will try to figure this out automatically. erl_xcomp_bigendian=yes -## `erl_xcomp_clock_gettime_cpu_time` - `yes|no`. Defaults to `no`. If `yes`, -## the target system must have a working `clock_gettime()` implementation -## that can be used for retrieving process CPU time. +# * `erl_xcomp_clock_gettime_cpu_time' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `clock_gettime()' implementation +# that can be used for retrieving process CPU time. #erl_xcomp_clock_gettime_cpu_time= -## `erl_xcomp_getaddrinfo` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have a working `getaddrinfo()` implementation that can -## handle both IPv4 and IPv6. +# * `erl_xcomp_getaddrinfo' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a working `getaddrinfo()' implementation that can +# handle both IPv4 and IPv6. #erl_xcomp_getaddrinfo= -## `erl_xcomp_gethrvtime_procfs_ioctl` - `yes|no`. Defaults to `no`. If `yes`, -## the target system must have a working `gethrvtime()` implementation and -## is used with procfs `ioctl()`. +# * `erl_xcomp_gethrvtime_procfs_ioctl' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `gethrvtime()' implementation and +# is used with procfs `ioctl()'. #erl_xcomp_gethrvtime_procfs_ioctl= -## `erl_xcomp_dlsym_brk_wrappers` - `yes|no`. Defaults to `no`. If `yes`, the -## target system must have a working `dlsym(RTLD_NEXT, <S>)` implementation -## that can be used on `brk` and `sbrk` symbols used by the `malloc()` -## implementation in use, and by this track the `malloc()` implementations -## core memory usage. This is currently only used by unsupported features. +# * `erl_xcomp_dlsym_brk_wrappers' - `yes|no'. Defaults to `no'. If `yes', the +# target system must have a working `dlsym(RTLD_NEXT, <S>)' implementation +# that can be used on `brk' and `sbrk' symbols used by the `malloc()' +# implementation in use, and by this track the `malloc()' implementations +# core memory usage. This is currently only used by unsupported features. #erl_xcomp_dlsym_brk_wrappers= -## `erl_xcomp_kqueue` - `yes|no`. Defaults to `no`. If `yes`, the target system -## must have a working `kqueue()` implementation that returns a file -## descriptor which can be used by `poll()` and/or `select()`. If `no` and -## the target system has not got `epoll()` or `/dev/poll`, the kernel-poll -## feature will be disabled. +# * `erl_xcomp_kqueue' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a working `kqueue()' implementation that returns a file +# descriptor which can be used by `poll()' and/or `select()'. If `no' and +# the target system has not got `epoll()' or `/dev/poll', the kernel-poll +# feature will be disabled. #erl_xcomp_kqueue= -## `erl_xcomp_linux_clock_gettime_correction` - `yes|no`. Defaults to `yes` on -## Linux; otherwise, `no`. If `yes`, `clock_gettime(CLOCK_MONOTONIC, _)` on -## the target system must work. This variable is recommended to be set to -## `no` on Linux systems with kernel versions less than 2.6. +# * `erl_xcomp_linux_clock_gettime_correction' - `yes|no'. Defaults to `yes' on +# Linux; otherwise, `no'. If `yes', `clock_gettime(CLOCK_MONOTONIC, _)' on +# the target system must work. This variable is recommended to be set to +# `no' on Linux systems with kernel versions less than 2.6. #erl_xcomp_linux_clock_gettime_correction= -## `erl_xcomp_linux_nptl` - `yes|no`. Defaults to `yes` on Linux; otherwise, -## `no`. If `yes`, the target system must have NPTL (Native POSIX Thread -## Library). Older Linux systems have LinuxThreads instead of NPTL (Linux -## kernel versions typically less than 2.6). +# * `erl_xcomp_linux_nptl' - `yes|no'. Defaults to `yes' on Linux; otherwise, +# `no'. If `yes', the target system must have NPTL (Native POSIX Thread +# Library). Older Linux systems have LinuxThreads instead of NPTL (Linux +# kernel versions typically less than 2.6). #erl_xcomp_linux_nptl= -## `erl_xcomp_linux_usable_sigaltstack` - `yes|no`. Defaults to `yes` on Linux; -## otherwise, `no`. If `yes`, `sigaltstack()` must be usable on the target -## system. `sigaltstack()` on Linux kernel versions less than 2.4 are -## broken. +# * `erl_xcomp_linux_usable_sigaltstack' - `yes|no'. Defaults to `yes' on Linux; +# otherwise, `no'. If `yes', `sigaltstack()' must be usable on the target +# system. `sigaltstack()' on Linux kernel versions less than 2.4 are +# broken. #erl_xcomp_linux_usable_sigaltstack= -## `erl_xcomp_linux_usable_sigusrx` - `yes|no`. Defaults to `yes`. If `yes`, -## the `SIGUSR1` and `SIGUSR2` signals must be usable by the ERTS. Old -## LinuxThreads thread libraries (Linux kernel versions typically less than -## 2.2) used these signals and made them unusable by the ERTS. +# * `erl_xcomp_linux_usable_sigusrx' - `yes|no'. Defaults to `yes'. If `yes', +# the `SIGUSR1' and `SIGUSR2' signals must be usable by the ERTS. Old +# LinuxThreads thread libraries (Linux kernel versions typically less than +# 2.2) used these signals and made them unusable by the ERTS. #erl_xcomp_linux_usable_sigusrx= -## `erl_xcomp_poll` - `yes|no`. Defaults to `no` on Darwin/MacOSX; otherwise, -## `yes`. If `yes`, the target system must have a working `poll()` -## implementation that also can handle devices. If `no`, `select()` will be -## used instead of `poll()`. +# * `erl_xcomp_poll' - `yes|no'. Defaults to `no' on Darwin/MacOSX; otherwise, +# `yes'. If `yes', the target system must have a working `poll()' +# implementation that also can handle devices. If `no', `select()' will be +# used instead of `poll()'. #erl_xcomp_poll= -## `erl_xcomp_putenv_copy` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have a `putenv()` implementation that stores a copy of the -## key/value pair. +# * `erl_xcomp_putenv_copy' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a `putenv()' implementation that stores a copy of the +# key/value pair. #erl_xcomp_putenv_copy= -## `erl_xcomp_reliable_fpe` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have reliable floating point exceptions. +# * `erl_xcomp_reliable_fpe' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have reliable floating point exceptions. #erl_xcomp_reliable_fpe= -#### +## ----------------------------------------------------------------------------- diff --git a/xcomp/erl-xcomp-x86_64-saf-linux-gnu.conf b/xcomp/erl-xcomp-x86_64-saf-linux-gnu.conf index a0dd7c9115..f645ddbd96 100644 --- a/xcomp/erl-xcomp-x86_64-saf-linux-gnu.conf +++ b/xcomp/erl-xcomp-x86_64-saf-linux-gnu.conf @@ -1,258 +1,258 @@ -#### -*-shell-script-*- -#### -#### %CopyrightBegin% -#### -#### Copyright Ericsson AB 2010. All Rights Reserved. -#### -#### The contents of this file are subject to the Erlang Public License, -#### Version 1.1, (the "License"); you may not use this file except in -#### compliance with the License. You should have received a copy of the -#### Erlang Public License along with this software. If not, it can be -#### retrieved online at http://www.erlang.org/. -#### -#### Software distributed under the License is distributed on an "AS IS" -#### basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See -#### the License for the specific language governing rights and limitations -#### under the License. -#### -#### %CopyrightEnd% -#### -#### File: erl-xcomp-x86_64-saf-linux-gnu.conf -#### Author: Rickard Green -#### -#### -------------------------------------------------------------------------- -#### When cross compiling Erlang/OTP using `otp_build`, copy this file and set -#### the variables needed below. Then pass the path to the copy of this file as -#### an argument to `otp_build` in the configure stage: -#### `otp_build configure --xcomp-conf=<FILE>` -#### -------------------------------------------------------------------------- - -### Note that you cannot define arbitrary variables in a cross compilation -### configuration file. Only the ones listed below will be guaranteed to be -### visible throughout the whole execution of all `configure` scripts. Other -### variables needs to be defined as arguments to `configure` or exported in -### the environment. - -### ### Variables for `otp_build` Only ### - -### Variables in this section are only used, when configuring Erlang/OTP for -### cross compilation using `$ERL_TOP/otp_build configure`. - -### *NOTE*! These variables currently have *no* effect if you configure using -### the `configure` script directly. - -## `erl_xcomp_build` - The build system used. This value will be passed as -## `--build=$erl_xcomp_build` argument to the `configure` script. It does -## not have to be a full `CPU-VENDOR-OS` triplet, but can be. The full -## `CPU-VENDOR-OS` triplet will be created by -## `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build`. -## If set to `guess`, the build system will be guessed using -## `$ERL_TOP/erts/autoconf/config.guess`. +## -*-shell-script-*- +## +## %CopyrightBegin% +## +## Copyright Ericsson AB 2010. All Rights Reserved. +## +## The contents of this file are subject to the Erlang Public License, +## Version 1.1, (the "License"); you may not use this file except in +## compliance with the License. You should have received a copy of the +## Erlang Public License along with this software. If not, it can be +## retrieved online at http://www.erlang.org/. +## +## Software distributed under the License is distributed on an "AS IS" +## basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See +## the License for the specific language governing rights and limitations +## under the License. +## +## %CopyrightEnd% +## +## File: erl-xcomp-x86_64-saf-linux-gnu.conf +## Author: Rickard Green +## +## ----------------------------------------------------------------------------- +## When cross compiling Erlang/OTP using `otp_build', copy this file and set +## the variables needed below. Then pass the path to the copy of this file as +## an argument to `otp_build' in the configure stage: +## `otp_build configure --xcomp-conf=<FILE>' +## ----------------------------------------------------------------------------- + +## Note that you cannot define arbitrary variables in a cross compilation +## configuration file. Only the ones listed below will be guaranteed to be +## visible throughout the whole execution of all `configure' scripts. Other +## variables needs to be defined as arguments to `configure' or exported in +## the environment. + +## -- Variables for `otp_build' Only ------------------------------------------- + +## Variables in this section are only used, when configuring Erlang/OTP for +## cross compilation using `$ERL_TOP/otp_build configure'. + +## *NOTE*! These variables currently have *no* effect if you configure using +## the `configure' script directly. + +# * `erl_xcomp_build' - The build system used. This value will be passed as +# `--build=$erl_xcomp_build' argument to the `configure' script. It does +# not have to be a full `CPU-VENDOR-OS' triplet, but can be. The full +# `CPU-VENDOR-OS' triplet will be created by +# `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build'. If set to `guess', +# the build system will be guessed using +# `$ERL_TOP/erts/autoconf/config.guess'. erl_xcomp_build=guess -## `erl_xcomp_host` - Cross host/target system to build for. This value will -## be passed as `--host=$erl_xcomp_host` argument to the `configure` script. -## It does not have to be a full `CPU-VENDOR-OS` triplet, but can be. The -## full `CPU-VENDOR-OS` triplet will be created by: -## `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host` +# * `erl_xcomp_host' - Cross host/target system to build for. This value will +# be passed as `--host=$erl_xcomp_host' argument to the `configure' script. +# It does not have to be a full `CPU-VENDOR-OS' triplet, but can be. The +# full `CPU-VENDOR-OS' triplet will be created by +# `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host'. erl_xcomp_host=x86_64-saf-linux-gnu -## `erl_xcomp_configure_flags` - Extra configure flags to pass to the -## `configure` script. +# * `erl_xcomp_configure_flags' - Extra configure flags to pass to the +# `configure' script. #erl_xcomp_configure_flags= -### ### Cross Compiler and Other Tools ### +## -- Cross Compiler and Other Tools ------------------------------------------- -### If the cross compilation tools are prefixed by `<HOST>-` you probably do -### not need to set these variables (where `<HOST>` is what has been passed as -### `--host=<HOST>` argument to `configure`). +## If the cross compilation tools are prefixed by `<HOST>-' you probably do +## not need to set these variables (where `<HOST>' is what has been passed as +## `--host=<HOST>' argument to `configure'). -### All variables in this section can also be used when native compiling. +## All variables in this section can also be used when native compiling. -## `CC` - C compiler. +# * `CC' - C compiler. CC=x86_64-saf-gcc -## `CFLAGS` - C compiler flags. +# * `CFLAGS' - C compiler flags. #CFLAGS= -## `STATIC_CFLAGS` - Static C compiler flags. +# * `STATIC_CFLAGS' - Static C compiler flags. #STATIC_CFLAGS= -## `CFLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library -## search path for the shared libraries. Note that this actually is a -## linker flag, but it needs to be passed via the compiler. +# * `CFLAG_RUNTIME_LIBRARY_PATH' - This flag should set runtime library +# search path for the shared libraries. Note that this actually is a +# linker flag, but it needs to be passed via the compiler. #CFLAG_RUNTIME_LIBRARY_PATH= -## `CPP` - C pre-processor. +# * `CPP' - C pre-processor. #CPP= -## `CPPFLAGS` - C pre-processor flags. +# * `CPPFLAGS' - C pre-processor flags. #CPPFLAGS= -## `CXX` - C++ compiler. +# * `CXX' - C++ compiler. CXX=x86_64-saf-g++ -## `CXXFLAGS` - C++ compiler flags. +# * `CXXFLAGS' - C++ compiler flags. #CXXFLAGS= -## `LD` - Linker. +# * `LD' - Linker. LD=x86_64-saf-ld -## `LDFLAGS` - Linker flags. +# * `LDFLAGS' - Linker flags. #LDFLAGS= -## `LIBS` - Libraries. +# * `LIBS' - Libraries. #LIBS= -### #### *D*ynamic *E*rlang *D*river Linking #### +## -- *D*ynamic *E*rlang *D*river Linking -- -### *NOTE*! Either set all or none of the `DED_LD*` variables. +## *NOTE*! Either set all or none of the `DED_LD*' variables. -## `DED_LD` - Linker for Dynamically loaded Erlang Drivers. +# * `DED_LD' - Linker for Dynamically loaded Erlang Drivers. #DED_LD= -## `DED_LDFLAGS` - Linker flags to use with `DED_LD`. +# * `DED_LDFLAGS' - Linker flags to use with `DED_LD'. #DED_LDFLAGS= -## `DED_LD_FLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library -## search path for shared libraries when linking with `DED_LD`. +# * `DED_LD_FLAG_RUNTIME_LIBRARY_PATH' - This flag should set runtime library +# search path for shared libraries when linking with `DED_LD'. #DED_LD_FLAG_RUNTIME_LIBRARY_PATH= -### #### Large File Support #### +## -- Large File Support -- -### *NOTE*! Either set all or none of the `LFS_*` variables. +## *NOTE*! Either set all or none of the `LFS_*' variables. -## `LFS_CFLAGS` - Large file support C compiler flags. +# * `LFS_CFLAGS' - Large file support C compiler flags. #LFS_CFLAGS= -## `LFS_LDFLAGS` - Large file support linker flags. +# * `LFS_LDFLAGS' - Large file support linker flags. #LFS_LDFLAGS= -## `LFS_LIBS` - Large file support libraries. +# * `LFS_LIBS' - Large file support libraries. #LFS_LIBS= -### #### Other Tools #### +## -- Other Tools -- -## `RANLIB` - `ranlib` archive index tool. +# * `RANLIB' - `ranlib' archive index tool. RANLIB=x86_64-saf-ranlib -## `AR` - `ar` archiving tool. +# * `AR' - `ar' archiving tool. AR=x86_64-saf-ar -## `GETCONF` - `getconf` system configuration inspection tool. `getconf` is -## currently used for finding out large file support flags to use, and -## on Linux systems for finding out if we have an NPTL thread library or -## not. +# * `GETCONF' - `getconf' system configuration inspection tool. `getconf' is +# currently used for finding out large file support flags to use, and +# on Linux systems for finding out if we have an NPTL thread library or +# not. #GETCONF= -### ### Cross System Root Locations ### +## -- Cross System Root Locations ---------------------------------------------- -## `erl_xcomp_sysroot` - The absolute path to the system root of the cross -## compilation environment. Currently, the `crypto`, `odbc`, `ssh` and -## `ssl` applications need the system root. These applications will be -## skipped if the system root has not been set. The system root might be -## needed for other things too. If this is the case and the system root -## has not been set, `configure` will fail and request you to set it. +# * `erl_xcomp_sysroot' - The absolute path to the system root of the cross +# compilation environment. Currently, the `crypto', `odbc', `ssh' and +# `ssl' applications need the system root. These applications will be +# skipped if the system root has not been set. The system root might be +# needed for other things too. If this is the case and the system root +# has not been set, `configure' will fail and request you to set it. erl_xcomp_sysroot="$SAF_SYSROOT_X86_64" -## `erl_xcomp_isysroot` - The absolute path to the system root for includes -## of the cross compilation environment. If not set, this value defaults -## to `$erl_xcomp_sysroot`, i.e., only set this value if the include system -## root path is not the same as the system root path. +# * `erl_xcomp_isysroot' - The absolute path to the system root for includes +# of the cross compilation environment. If not set, this value defaults +# to `$erl_xcomp_sysroot', i.e., only set this value if the include system +# root path is not the same as the system root path. #erl_xcomp_isysroot= -### ### Optional Feature, and Bug Tests ### +## -- Optional Feature, and Bug Tests ------------------------------------------ -### These tests cannot (always) be done automatically when cross compiling. You -### usually do not need to set these variables. Only set these if you really -### know what you are doing. +## These tests cannot (always) be done automatically when cross compiling. You +## usually do not need to set these variables. Only set these if you really +## know what you are doing. -### Note that some of these values will override results of tests performed -### by `configure`, and some will not be used until `configure` is sure that -### it cannot figure the result out. +## Note that some of these values will override results of tests performed +## by `configure', and some will not be used until `configure' is sure that +## it cannot figure the result out. -### The `configure` script will issue a warning when a default value is used. -### When a variable has been set, no warning will be issued. +## The `configure' script will issue a warning when a default value is used. +## When a variable has been set, no warning will be issued. -## `erl_xcomp_after_morecore_hook` - `yes|no`. Defaults to `no`. If `yes`, the -## target system must have a working `__after_morecore_hook` that can be -## used for tracking used `malloc()` implementations core memory usage. -## This is currently only used by unsupported features. +# * `erl_xcomp_after_morecore_hook' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `__after_morecore_hook' that can be +# used for tracking used `malloc()' implementations core memory usage. +# This is currently only used by unsupported features. erl_xcomp_after_morecore_hook=yes -## `erl_xcomp_bigendian` - `yes|no`. No default. If `yes`, the target system -## must be big endian. If `no`, little endian. This can often be -## automatically detected, but not always. If not automatically detected, -## `configure` will fail unless this variable is set. Since no default -## value is used, `configure` will try to figure this out automatically. +# * `erl_xcomp_bigendian' - `yes|no'. No default. If `yes', the target system +# must be big endian. If `no', little endian. This can often be +# automatically detected, but not always. If not automatically detected, +# `configure' will fail unless this variable is set. Since no default +# value is used, `configure' will try to figure this out automatically. #erl_xcomp_bigendian= -## `erl_xcomp_clock_gettime_cpu_time` - `yes|no`. Defaults to `no`. If `yes`, -## the target system must have a working `clock_gettime()` implementation -## that can be used for retrieving process CPU time. +# * `erl_xcomp_clock_gettime_cpu_time' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `clock_gettime()' implementation +# that can be used for retrieving process CPU time. #erl_xcomp_clock_gettime_cpu_time= -## `erl_xcomp_getaddrinfo` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have a working `getaddrinfo()` implementation that can -## handle both IPv4 and IPv6. +# * `erl_xcomp_getaddrinfo' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a working `getaddrinfo()' implementation that can +# handle both IPv4 and IPv6. erl_xcomp_getaddrinfo=yes -## `erl_xcomp_gethrvtime_procfs_ioctl` - `yes|no`. Defaults to `no`. If `yes`, -## the target system must have a working `gethrvtime()` implementation and -## is used with procfs `ioctl()`. +# * `erl_xcomp_gethrvtime_procfs_ioctl' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `gethrvtime()' implementation and +# is used with procfs `ioctl()'. #erl_xcomp_gethrvtime_procfs_ioctl= -## `erl_xcomp_dlsym_brk_wrappers` - `yes|no`. Defaults to `no`. If `yes`, the -## target system must have a working `dlsym(RTLD_NEXT, <S>)` implementation -## that can be used on `brk` and `sbrk` symbols used by the `malloc()` -## implementation in use, and by this track the `malloc()` implementations -## core memory usage. This is currently only used by unsupported features. +# * `erl_xcomp_dlsym_brk_wrappers' - `yes|no'. Defaults to `no'. If `yes', the +# target system must have a working `dlsym(RTLD_NEXT, <S>)' implementation +# that can be used on `brk' and `sbrk' symbols used by the `malloc()' +# implementation in use, and by this track the `malloc()' implementations +# core memory usage. This is currently only used by unsupported features. #erl_xcomp_dlsym_brk_wrappers= -## `erl_xcomp_kqueue` - `yes|no`. Defaults to `no`. If `yes`, the target system -## must have a working `kqueue()` implementation that returns a file -## descriptor which can be used by `poll()` and/or `select()`. If `no` and -## the target system has not got `epoll()` or `/dev/poll`, the kernel-poll -## feature will be disabled. +# * `erl_xcomp_kqueue' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a working `kqueue()' implementation that returns a file +# descriptor which can be used by `poll()' and/or `select()'. If `no' and +# the target system has not got `epoll()' or `/dev/poll', the kernel-poll +# feature will be disabled. #erl_xcomp_kqueue= -## `erl_xcomp_linux_clock_gettime_correction` - `yes|no`. Defaults to `yes` on -## Linux; otherwise, `no`. If `yes`, `clock_gettime(CLOCK_MONOTONIC, _)` on -## the target system must work. This variable is recommended to be set to -## `no` on Linux systems with kernel versions less than 2.6. +# * `erl_xcomp_linux_clock_gettime_correction' - `yes|no'. Defaults to `yes' on +# Linux; otherwise, `no'. If `yes', `clock_gettime(CLOCK_MONOTONIC, _)' on +# the target system must work. This variable is recommended to be set to +# `no' on Linux systems with kernel versions less than 2.6. #erl_xcomp_linux_clock_gettime_correction= -## `erl_xcomp_linux_nptl` - `yes|no`. Defaults to `yes` on Linux; otherwise, -## `no`. If `yes`, the target system must have NPTL (Native POSIX Thread -## Library). Older Linux systems have LinuxThreads instead of NPTL (Linux -## kernel versions typically less than 2.6). +# * `erl_xcomp_linux_nptl' - `yes|no'. Defaults to `yes' on Linux; otherwise, +# `no'. If `yes', the target system must have NPTL (Native POSIX Thread +# Library). Older Linux systems have LinuxThreads instead of NPTL (Linux +# kernel versions typically less than 2.6). #erl_xcomp_linux_nptl= -## `erl_xcomp_linux_usable_sigaltstack` - `yes|no`. Defaults to `yes` on Linux; -## otherwise, `no`. If `yes`, `sigaltstack()` must be usable on the target -## system. `sigaltstack()` on Linux kernel versions less than 2.4 are -## broken. +# * `erl_xcomp_linux_usable_sigaltstack' - `yes|no'. Defaults to `yes' on Linux; +# otherwise, `no'. If `yes', `sigaltstack()' must be usable on the target +# system. `sigaltstack()' on Linux kernel versions less than 2.4 are +# broken. #erl_xcomp_linux_usable_sigaltstack= -## `erl_xcomp_linux_usable_sigusrx` - `yes|no`. Defaults to `yes`. If `yes`, -## the `SIGUSR1` and `SIGUSR2` signals must be usable by the ERTS. Old -## LinuxThreads thread libraries (Linux kernel versions typically less than -## 2.2) used these signals and made them unusable by the ERTS. +# * `erl_xcomp_linux_usable_sigusrx' - `yes|no'. Defaults to `yes'. If `yes', +# the `SIGUSR1' and `SIGUSR2' signals must be usable by the ERTS. Old +# LinuxThreads thread libraries (Linux kernel versions typically less than +# 2.2) used these signals and made them unusable by the ERTS. #erl_xcomp_linux_usable_sigusrx= -## `erl_xcomp_poll` - `yes|no`. Defaults to `no` on Darwin/MacOSX; otherwise, -## `yes`. If `yes`, the target system must have a working `poll()` -## implementation that also can handle devices. If `no`, `select()` will be -## used instead of `poll()`. +# * `erl_xcomp_poll' - `yes|no'. Defaults to `no' on Darwin/MacOSX; otherwise, +# `yes'. If `yes', the target system must have a working `poll()' +# implementation that also can handle devices. If `no', `select()' will be +# used instead of `poll()'. #erl_xcomp_poll= -## `erl_xcomp_putenv_copy` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have a `putenv()` implementation that stores a copy of the -## key/value pair. +# * `erl_xcomp_putenv_copy' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a `putenv()' implementation that stores a copy of the +# key/value pair. #erl_xcomp_putenv_copy= -## `erl_xcomp_reliable_fpe` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have reliable floating point exceptions. +# * `erl_xcomp_reliable_fpe' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have reliable floating point exceptions. #erl_xcomp_reliable_fpe= -#### +## ----------------------------------------------------------------------------- diff --git a/xcomp/erl-xcomp.conf.template b/xcomp/erl-xcomp.conf.template index 090f92c15f..eb331ffe92 100644 --- a/xcomp/erl-xcomp.conf.template +++ b/xcomp/erl-xcomp.conf.template @@ -1,258 +1,258 @@ -#### -*-shell-script-*- -#### -#### %CopyrightBegin% -#### -#### Copyright Ericsson AB 2009-2010. All Rights Reserved. -#### -#### The contents of this file are subject to the Erlang Public License, -#### Version 1.1, (the "License"); you may not use this file except in -#### compliance with the License. You should have received a copy of the -#### Erlang Public License along with this software. If not, it can be -#### retrieved online at http://www.erlang.org/. -#### -#### Software distributed under the License is distributed on an "AS IS" -#### basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See -#### the License for the specific language governing rights and limitations -#### under the License. -#### -#### %CopyrightEnd% -#### -#### File: erl-xcomp.conf.template -#### Author: Rickard Green -#### -#### -------------------------------------------------------------------------- -#### When cross compiling Erlang/OTP using `otp_build`, copy this file and set -#### the variables needed below. Then pass the path to the copy of this file as -#### an argument to `otp_build` in the configure stage: -#### `otp_build configure --xcomp-conf=<FILE>` -#### -------------------------------------------------------------------------- - -### Note that you cannot define arbitrary variables in a cross compilation -### configuration file. Only the ones listed below will be guaranteed to be -### visible throughout the whole execution of all `configure` scripts. Other -### variables needs to be defined as arguments to `configure` or exported in -### the environment. - -### ### Variables for `otp_build` Only ### - -### Variables in this section are only used, when configuring Erlang/OTP for -### cross compilation using `$ERL_TOP/otp_build configure`. - -### *NOTE*! These variables currently have *no* effect if you configure using -### the `configure` script directly. - -## `erl_xcomp_build` - The build system used. This value will be passed as -## `--build=$erl_xcomp_build` argument to the `configure` script. It does -## not have to be a full `CPU-VENDOR-OS` triplet, but can be. The full -## `CPU-VENDOR-OS` triplet will be created by -## `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build`. -## If set to `guess`, the build system will be guessed using -## `$ERL_TOP/erts/autoconf/config.guess`. +## -*-shell-script-*- +## +## %CopyrightBegin% +## +## Copyright Ericsson AB 2009-2010. All Rights Reserved. +## +## The contents of this file are subject to the Erlang Public License, +## Version 1.1, (the "License"); you may not use this file except in +## compliance with the License. You should have received a copy of the +## Erlang Public License along with this software. If not, it can be +## retrieved online at http://www.erlang.org/. +## +## Software distributed under the License is distributed on an "AS IS" +## basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See +## the License for the specific language governing rights and limitations +## under the License. +## +## %CopyrightEnd% +## +## File: erl-xcomp.conf.template +## Author: Rickard Green +## +## ----------------------------------------------------------------------------- +## When cross compiling Erlang/OTP using `otp_build', copy this file and set +## the variables needed below. Then pass the path to the copy of this file as +## an argument to `otp_build' in the configure stage: +## `otp_build configure --xcomp-conf=<FILE>' +## ----------------------------------------------------------------------------- + +## Note that you cannot define arbitrary variables in a cross compilation +## configuration file. Only the ones listed below will be guaranteed to be +## visible throughout the whole execution of all `configure' scripts. Other +## variables needs to be defined as arguments to `configure' or exported in +## the environment. + +## -- Variables for `otp_build' Only ------------------------------------------- + +## Variables in this section are only used, when configuring Erlang/OTP for +## cross compilation using `$ERL_TOP/otp_build configure'. + +## *NOTE*! These variables currently have *no* effect if you configure using +## the `configure' script directly. + +# * `erl_xcomp_build' - The build system used. This value will be passed as +# `--build=$erl_xcomp_build' argument to the `configure' script. It does +# not have to be a full `CPU-VENDOR-OS' triplet, but can be. The full +# `CPU-VENDOR-OS' triplet will be created by +# `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_build'. If set to `guess', +# the build system will be guessed using +# `$ERL_TOP/erts/autoconf/config.guess'. #erl_xcomp_build= -## `erl_xcomp_host` - Cross host/target system to build for. This value will -## be passed as `--host=$erl_xcomp_host` argument to the `configure` script. -## It does not have to be a full `CPU-VENDOR-OS` triplet, but can be. The -## full `CPU-VENDOR-OS` triplet will be created by: -## `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host` +# * `erl_xcomp_host' - Cross host/target system to build for. This value will +# be passed as `--host=$erl_xcomp_host' argument to the `configure' script. +# It does not have to be a full `CPU-VENDOR-OS' triplet, but can be. The +# full `CPU-VENDOR-OS' triplet will be created by +# `$ERL_TOP/erts/autoconf/config.sub $erl_xcomp_host'. #erl_xcomp_host= -## `erl_xcomp_configure_flags` - Extra configure flags to pass to the -## `configure` script. +# * `erl_xcomp_configure_flags' - Extra configure flags to pass to the +# `configure' script. #erl_xcomp_configure_flags= -### ### Cross Compiler and Other Tools ### +## -- Cross Compiler and Other Tools ------------------------------------------- -### If the cross compilation tools are prefixed by `<HOST>-` you probably do -### not need to set these variables (where `<HOST>` is what has been passed as -### `--host=<HOST>` argument to `configure`). +## If the cross compilation tools are prefixed by `<HOST>-' you probably do +## not need to set these variables (where `<HOST>' is what has been passed as +## `--host=<HOST>' argument to `configure'). -### All variables in this section can also be used when native compiling. +## All variables in this section can also be used when native compiling. -## `CC` - C compiler. +# * `CC' - C compiler. #CC= -## `CFLAGS` - C compiler flags. +# * `CFLAGS' - C compiler flags. #CFLAGS= -## `STATIC_CFLAGS` - Static C compiler flags. +# * `STATIC_CFLAGS' - Static C compiler flags. #STATIC_CFLAGS= -## `CFLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library -## search path for the shared libraries. Note that this actually is a -## linker flag, but it needs to be passed via the compiler. +# * `CFLAG_RUNTIME_LIBRARY_PATH' - This flag should set runtime library +# search path for the shared libraries. Note that this actually is a +# linker flag, but it needs to be passed via the compiler. #CFLAG_RUNTIME_LIBRARY_PATH= -## `CPP` - C pre-processor. +# * `CPP' - C pre-processor. #CPP= -## `CPPFLAGS` - C pre-processor flags. +# * `CPPFLAGS' - C pre-processor flags. #CPPFLAGS= -## `CXX` - C++ compiler. +# * `CXX' - C++ compiler. #CXX= -## `CXXFLAGS` - C++ compiler flags. +# * `CXXFLAGS' - C++ compiler flags. #CXXFLAGS= -## `LD` - Linker. +# * `LD' - Linker. #LD= -## `LDFLAGS` - Linker flags. +# * `LDFLAGS' - Linker flags. #LDFLAGS= -## `LIBS` - Libraries. +# * `LIBS' - Libraries. #LIBS= -### #### *D*ynamic *E*rlang *D*river Linking #### +## -- *D*ynamic *E*rlang *D*river Linking -- -### *NOTE*! Either set all or none of the `DED_LD*` variables. +## *NOTE*! Either set all or none of the `DED_LD*' variables. -## `DED_LD` - Linker for Dynamically loaded Erlang Drivers. +# * `DED_LD' - Linker for Dynamically loaded Erlang Drivers. #DED_LD= -## `DED_LDFLAGS` - Linker flags to use with `DED_LD`. +# * `DED_LDFLAGS' - Linker flags to use with `DED_LD'. #DED_LDFLAGS= -## `DED_LD_FLAG_RUNTIME_LIBRARY_PATH` - This flag should set runtime library -## search path for shared libraries when linking with `DED_LD`. +# * `DED_LD_FLAG_RUNTIME_LIBRARY_PATH' - This flag should set runtime library +# search path for shared libraries when linking with `DED_LD'. #DED_LD_FLAG_RUNTIME_LIBRARY_PATH= -### #### Large File Support #### +## -- Large File Support -- -### *NOTE*! Either set all or none of the `LFS_*` variables. +## *NOTE*! Either set all or none of the `LFS_*' variables. -## `LFS_CFLAGS` - Large file support C compiler flags. +# * `LFS_CFLAGS' - Large file support C compiler flags. #LFS_CFLAGS= -## `LFS_LDFLAGS` - Large file support linker flags. +# * `LFS_LDFLAGS' - Large file support linker flags. #LFS_LDFLAGS= -## `LFS_LIBS` - Large file support libraries. +# * `LFS_LIBS' - Large file support libraries. #LFS_LIBS= -### #### Other Tools #### +## -- Other Tools -- -## `RANLIB` - `ranlib` archive index tool. +# * `RANLIB' - `ranlib' archive index tool. #RANLIB= -## `AR` - `ar` archiving tool. +# * `AR' - `ar' archiving tool. #AR= -## `GETCONF` - `getconf` system configuration inspection tool. `getconf` is -## currently used for finding out large file support flags to use, and -## on Linux systems for finding out if we have an NPTL thread library or -## not. +# * `GETCONF' - `getconf' system configuration inspection tool. `getconf' is +# currently used for finding out large file support flags to use, and +# on Linux systems for finding out if we have an NPTL thread library or +# not. #GETCONF= -### ### Cross System Root Locations ### +## -- Cross System Root Locations ---------------------------------------------- -## `erl_xcomp_sysroot` - The absolute path to the system root of the cross -## compilation environment. Currently, the `crypto`, `odbc`, `ssh` and -## `ssl` applications need the system root. These applications will be -## skipped if the system root has not been set. The system root might be -## needed for other things too. If this is the case and the system root -## has not been set, `configure` will fail and request you to set it. +# * `erl_xcomp_sysroot' - The absolute path to the system root of the cross +# compilation environment. Currently, the `crypto', `odbc', `ssh' and +# `ssl' applications need the system root. These applications will be +# skipped if the system root has not been set. The system root might be +# needed for other things too. If this is the case and the system root +# has not been set, `configure' will fail and request you to set it. #erl_xcomp_sysroot= -## `erl_xcomp_isysroot` - The absolute path to the system root for includes -## of the cross compilation environment. If not set, this value defaults -## to `$erl_xcomp_sysroot`, i.e., only set this value if the include system -## root path is not the same as the system root path. +# * `erl_xcomp_isysroot' - The absolute path to the system root for includes +# of the cross compilation environment. If not set, this value defaults +# to `$erl_xcomp_sysroot', i.e., only set this value if the include system +# root path is not the same as the system root path. #erl_xcomp_isysroot= -### ### Optional Feature, and Bug Tests ### +## -- Optional Feature, and Bug Tests ------------------------------------------ -### These tests cannot (always) be done automatically when cross compiling. You -### usually do not need to set these variables. Only set these if you really -### know what you are doing. +## These tests cannot (always) be done automatically when cross compiling. You +## usually do not need to set these variables. Only set these if you really +## know what you are doing. -### Note that some of these values will override results of tests performed -### by `configure`, and some will not be used until `configure` is sure that -### it cannot figure the result out. +## Note that some of these values will override results of tests performed +## by `configure', and some will not be used until `configure' is sure that +## it cannot figure the result out. -### The `configure` script will issue a warning when a default value is used. -### When a variable has been set, no warning will be issued. +## The `configure' script will issue a warning when a default value is used. +## When a variable has been set, no warning will be issued. -## `erl_xcomp_after_morecore_hook` - `yes|no`. Defaults to `no`. If `yes`, the -## target system must have a working `__after_morecore_hook` that can be -## used for tracking used `malloc()` implementations core memory usage. -## This is currently only used by unsupported features. +# * `erl_xcomp_after_morecore_hook' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `__after_morecore_hook' that can be +# used for tracking used `malloc()' implementations core memory usage. +# This is currently only used by unsupported features. #erl_xcomp_after_morecore_hook= -## `erl_xcomp_bigendian` - `yes|no`. No default. If `yes`, the target system -## must be big endian. If `no`, little endian. This can often be -## automatically detected, but not always. If not automatically detected, -## `configure` will fail unless this variable is set. Since no default -## value is used, `configure` will try to figure this out automatically. +# * `erl_xcomp_bigendian' - `yes|no'. No default. If `yes', the target system +# must be big endian. If `no', little endian. This can often be +# automatically detected, but not always. If not automatically detected, +# `configure' will fail unless this variable is set. Since no default +# value is used, `configure' will try to figure this out automatically. #erl_xcomp_bigendian= -## `erl_xcomp_clock_gettime_cpu_time` - `yes|no`. Defaults to `no`. If `yes`, -## the target system must have a working `clock_gettime()` implementation -## that can be used for retrieving process CPU time. +# * `erl_xcomp_clock_gettime_cpu_time' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `clock_gettime()' implementation +# that can be used for retrieving process CPU time. #erl_xcomp_clock_gettime_cpu_time= -## `erl_xcomp_getaddrinfo` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have a working `getaddrinfo()` implementation that can -## handle both IPv4 and IPv6. +# * `erl_xcomp_getaddrinfo' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a working `getaddrinfo()' implementation that can +# handle both IPv4 and IPv6. #erl_xcomp_getaddrinfo= -## `erl_xcomp_gethrvtime_procfs_ioctl` - `yes|no`. Defaults to `no`. If `yes`, -## the target system must have a working `gethrvtime()` implementation and -## is used with procfs `ioctl()`. +# * `erl_xcomp_gethrvtime_procfs_ioctl' - `yes|no'. Defaults to `no'. If `yes', +# the target system must have a working `gethrvtime()' implementation and +# is used with procfs `ioctl()'. #erl_xcomp_gethrvtime_procfs_ioctl= -## `erl_xcomp_dlsym_brk_wrappers` - `yes|no`. Defaults to `no`. If `yes`, the -## target system must have a working `dlsym(RTLD_NEXT, <S>)` implementation -## that can be used on `brk` and `sbrk` symbols used by the `malloc()` -## implementation in use, and by this track the `malloc()` implementations -## core memory usage. This is currently only used by unsupported features. +# * `erl_xcomp_dlsym_brk_wrappers' - `yes|no'. Defaults to `no'. If `yes', the +# target system must have a working `dlsym(RTLD_NEXT, <S>)' implementation +# that can be used on `brk' and `sbrk' symbols used by the `malloc()' +# implementation in use, and by this track the `malloc()' implementations +# core memory usage. This is currently only used by unsupported features. #erl_xcomp_dlsym_brk_wrappers= -## `erl_xcomp_kqueue` - `yes|no`. Defaults to `no`. If `yes`, the target system -## must have a working `kqueue()` implementation that returns a file -## descriptor which can be used by `poll()` and/or `select()`. If `no` and -## the target system has not got `epoll()` or `/dev/poll`, the kernel-poll -## feature will be disabled. +# * `erl_xcomp_kqueue' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a working `kqueue()' implementation that returns a file +# descriptor which can be used by `poll()' and/or `select()'. If `no' and +# the target system has not got `epoll()' or `/dev/poll', the kernel-poll +# feature will be disabled. #erl_xcomp_kqueue= -## `erl_xcomp_linux_clock_gettime_correction` - `yes|no`. Defaults to `yes` on -## Linux; otherwise, `no`. If `yes`, `clock_gettime(CLOCK_MONOTONIC, _)` on -## the target system must work. This variable is recommended to be set to -## `no` on Linux systems with kernel versions less than 2.6. +# * `erl_xcomp_linux_clock_gettime_correction' - `yes|no'. Defaults to `yes' on +# Linux; otherwise, `no'. If `yes', `clock_gettime(CLOCK_MONOTONIC, _)' on +# the target system must work. This variable is recommended to be set to +# `no' on Linux systems with kernel versions less than 2.6. #erl_xcomp_linux_clock_gettime_correction= -## `erl_xcomp_linux_nptl` - `yes|no`. Defaults to `yes` on Linux; otherwise, -## `no`. If `yes`, the target system must have NPTL (Native POSIX Thread -## Library). Older Linux systems have LinuxThreads instead of NPTL (Linux -## kernel versions typically less than 2.6). +# * `erl_xcomp_linux_nptl' - `yes|no'. Defaults to `yes' on Linux; otherwise, +# `no'. If `yes', the target system must have NPTL (Native POSIX Thread +# Library). Older Linux systems have LinuxThreads instead of NPTL (Linux +# kernel versions typically less than 2.6). #erl_xcomp_linux_nptl= -## `erl_xcomp_linux_usable_sigaltstack` - `yes|no`. Defaults to `yes` on Linux; -## otherwise, `no`. If `yes`, `sigaltstack()` must be usable on the target -## system. `sigaltstack()` on Linux kernel versions less than 2.4 are -## broken. +# * `erl_xcomp_linux_usable_sigaltstack' - `yes|no'. Defaults to `yes' on Linux; +# otherwise, `no'. If `yes', `sigaltstack()' must be usable on the target +# system. `sigaltstack()' on Linux kernel versions less than 2.4 are +# broken. #erl_xcomp_linux_usable_sigaltstack= -## `erl_xcomp_linux_usable_sigusrx` - `yes|no`. Defaults to `yes`. If `yes`, -## the `SIGUSR1` and `SIGUSR2` signals must be usable by the ERTS. Old -## LinuxThreads thread libraries (Linux kernel versions typically less than -## 2.2) used these signals and made them unusable by the ERTS. +# * `erl_xcomp_linux_usable_sigusrx' - `yes|no'. Defaults to `yes'. If `yes', +# the `SIGUSR1' and `SIGUSR2' signals must be usable by the ERTS. Old +# LinuxThreads thread libraries (Linux kernel versions typically less than +# 2.2) used these signals and made them unusable by the ERTS. #erl_xcomp_linux_usable_sigusrx= -## `erl_xcomp_poll` - `yes|no`. Defaults to `no` on Darwin/MacOSX; otherwise, -## `yes`. If `yes`, the target system must have a working `poll()` -## implementation that also can handle devices. If `no`, `select()` will be -## used instead of `poll()`. +# * `erl_xcomp_poll' - `yes|no'. Defaults to `no' on Darwin/MacOSX; otherwise, +# `yes'. If `yes', the target system must have a working `poll()' +# implementation that also can handle devices. If `no', `select()' will be +# used instead of `poll()'. #erl_xcomp_poll= -## `erl_xcomp_putenv_copy` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have a `putenv()` implementation that stores a copy of the -## key/value pair. +# * `erl_xcomp_putenv_copy' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have a `putenv()' implementation that stores a copy of the +# key/value pair. #erl_xcomp_putenv_copy= -## `erl_xcomp_reliable_fpe` - `yes|no`. Defaults to `no`. If `yes`, the target -## system must have reliable floating point exceptions. +# * `erl_xcomp_reliable_fpe' - `yes|no'. Defaults to `no'. If `yes', the target +# system must have reliable floating point exceptions. #erl_xcomp_reliable_fpe= -#### +## ----------------------------------------------------------------------------- |