diff options
Diffstat (limited to 'xcomp/erl-xcomp.conf.template')
| -rw-r--r-- | xcomp/erl-xcomp.conf.template | 334 |
1 files changed, 167 insertions, 167 deletions
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= -#### +## ----------------------------------------------------------------------------- |