diff options
author | Rickard Green <rickard@erlang.org> | 2021-05-15 22:49:35 +0200 |
---|---|---|
committer | Rickard Green <rickard@erlang.org> | 2021-05-19 17:26:42 +0200 |
commit | d1836adf2afa63e097c0d38b7dc93822ef482f80 (patch) | |
tree | 423c8c0510a47a30a6fa378087d8e052787a0787 /HOWTO | |
parent | 4cb0d303031a68fb48c92fbd1ce729af61745411 (diff) | |
download | erlang-d1836adf2afa63e097c0d38b7dc93822ef482f80.tar.gz |
Document and fix DED_LDFLAGS_CONFTEST
Diffstat (limited to 'HOWTO')
-rw-r--r-- | HOWTO/INSTALL-CROSS.md | 65 | ||||
-rw-r--r-- | HOWTO/INSTALL.md | 51 |
2 files changed, 56 insertions, 60 deletions
diff --git a/HOWTO/INSTALL-CROSS.md b/HOWTO/INSTALL-CROSS.md index 0fb58cd4af..322ff13340 100644 --- a/HOWTO/INSTALL-CROSS.md +++ b/HOWTO/INSTALL-CROSS.md @@ -355,65 +355,11 @@ cross compilation using `$ERL_TOP/otp_build 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. - -* `CC` - C compiler. - -* `CFLAGS` - 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. - -* `CPP` - C pre-processor. - -* `CPPFLAGS` - C pre-processor flags. - -* `CXX` - C++ compiler. - -* `CXXFLAGS` - C++ compiler flags. - -* `LD` - Linker. - -* `LDFLAGS` - Linker flags. - -* `LIBS` - Libraries. - -#### Dynamic Erlang Driver Linking #### - -> *NOTE*: Either set all or none of the `DED_LD*` variables. - -* `DED_LD` - Linker for Dynamically loaded Erlang Drivers. - -* `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`. - -#### Large File Support #### - -> *NOTE*: Either set all or none of the `LFS_*` variables. - -* `LFS_CFLAGS` - Large file support C compiler flags. - -* `LFS_LDFLAGS` - Large file support linker flags. - -* `LFS_LIBS` - Large file support libraries. - -#### Other Tools #### - -* `RANLIB` - `ranlib` archive index 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. +`--host=<HOST>` argument to `configure`). Compiler and other tools can +otherwise be identified via variables passed as arguments on the command +line to `configure`, in then xcomp file, or as environment variables. For +more information see the [Important Variables Inspected by configure][] +section of the [$ERL_TOP/HOWTO/INSTALL.md][] document. ### Cross System Root Locations ### @@ -529,6 +475,7 @@ When a variable has been set, no warning will be issued. [$ERL_TOP/HOWTO/INSTALL.md]: INSTALL.md [Building in Git]: INSTALL.md#How-to-Build-and-Install-ErlangOTP [How to Build the Documentation]: INSTALL.md#How-to-Build-and-Install-ErlangOTP_How-to-Build-the-Documentation + [Important Variables Inspected by configure]: INSTALL.md#Advanced-configuration-and-build-of-ErlangOTP_Configuring_Important-Variables-Inspected-by-configure [cross configuration variables]: #Currently-Used-Configuration-Variables [DESTDIR]: http://www.gnu.org/prep/standards/html_node/DESTDIR.html [?TOC]: true diff --git a/HOWTO/INSTALL.md b/HOWTO/INSTALL.md index 1351e46d96..3a041f7e6c 100644 --- a/HOWTO/INSTALL.md +++ b/HOWTO/INSTALL.md @@ -426,7 +426,56 @@ Some of the available `configure` options are: If you or your system has special requirements please read the `Makefile` for additional configuration information. -#### Updating configure scripts #### +#### Important Variables Inspected by configure #### + +##### Compiler and Linker ##### + +* `CC` - C compiler. +* `CFLAGS` - C compiler flags. Defaults to "-g -O2". If you set it, + these will be removed. +* `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. +* `CPP` - C pre-processor. +* `CPPFLAGS` - C pre-processor flags. +* `CXX` - C++ compiler. +* `CXXFLAGS` - C++ compiler flags. +* `LD` - Linker. +* `LDFLAGS` - Linker flags. +* `LIBS` - Libraries. + +##### Dynamic Erlang Driver Linking ##### + +> *NOTE*: Either set all or none of the `DED_LD*` variables (with the exception +> of `DED_LDFLAGS_CONFTEST`). + +* `DED_LD` - Linker for Dynamically loaded Erlang Drivers. +* `DED_LDFLAGS` - Linker flags to use with `DED_LD`. +* `DED_LDFLAGS_CONFTEST` - Linker flags to use with `DED_LD` in configure + link tests if `DED_LDFLAGS` cannot be used in such tests. If not set, + `DED_LDFLAGS` will be used in configure tests. +* `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_LDFLAGS` - Large file support linker flags. +* `LFS_LIBS` - Large file support libraries. + +##### Other Tools ##### + +* `RANLIB` - `ranlib` archive index 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. + +#### Updating configure Scripts #### Generated `configure` scripts are nowadays included in the git repository. |