xPack MinGW-w64 GCC v11.5.0-1 released

_posts/releases/mingw-w64-gcc/2024-07-28-mingw-w64-gcc-v11-5-0-1-released.md

@@ -0,0 +1,317 @@
+---
+title:  xPack MinGW-w64 GCC v11.5.0-1 released
+
+TODO: select one summary
+
+summary: "Version **11.5.0-1** is a maintenance release; it updates to
+the latest upstream master."
+
+summary: "Version **11.5.0-1** is a new release; it follows the official GNU GCC release."
+
+gcc_version: "11.5.0"
+gcc_version_major: "11"
+gcc_release_date: "19 July 2024"
+binutils_version: "2.42"
+binutils_release_url: "https://lists.gnu.org/archive/html/info-gnu/2024-01/msg00016.html"
+binutils_date: "29 Jan 2024"
+mingw_release: "12.0.0"
+
+version: "11.5.0-1"
+npm_subversion: "1"
+
+download_url: https://github.com/xpack-dev-tools/mingw-w64-gcc-xpack/releases/tag/v11.5.0-1/
+
+comments: true
+
+date: 2024-07-28 16:30:11 +0300
+
+# For Jekyll releases selection.
+categories:
+  - releases
+  - mingw-w64-gcc
+
+# For navigation; use scripts/createtag.sh in Jekyll.
+tags:
+  - releases
+  - gcc
+  - mingw
+  - mingw-w64
+
+---
+
+[The xPack MinGW-w64 GCC](https://xpack.github.io/mingw-w64-gcc/)
+is a standalone cross-platform binary distribution of
+[Mingw-w64](https://www.mingw-w64.org)
+[GCC](https://gcc.gnu.org).
+
+There are separate binaries for **Windows** (Intel 64-bit),
+**macOS** (Intel 64-bit, Apple Silicon 64-bit)
+and **GNU/Linux** (Intel 64-bit, Arm 32/64-bit).
+
+{% include note.html content="The main targets for the Arm binaries
+are the **Raspberry Pi** class devices (armv7l and aarch64;
+armv6 is not supported)." %}
+
+## Download
+
+The binary files are available from GitHub [Releases]({{ page.download_url }}).
+
+## Prerequisites
+
+- GNU/Linux Intel 64-bit: any system with **GLIBC 2.27** or higher
+  (like Ubuntu 18 or later, Debian 10 or later, RedHat 8 later,
+  Fedora 29 or later, etc)
+- GNU/Linux Arm 32/64-bit: any system with **GLIBC 2.27** or higher
+  (like Raspberry Pi OS, Ubuntu 18 or later, Debian 10 or later, RedHat 8 later,
+  Fedora 29 or later, etc)
+- Intel Windows 64-bit: Windows 7 with the Universal C Runtime
+  ([UCRT](https://support.microsoft.com/en-us/topic/update-for-universal-c-runtime-in-windows-c0514201-7fe6-95a3-b0a5-287930f3560c)),
+  Windows 8, Windows 10
+- Intel macOS 64-bit: 10.13 or later
+- Apple Silicon macOS 64-bit: 11.6 or later
+
+## Install
+
+The full details of installing the **xPack MinGW-w64 GCC** on various platforms
+are presented in the separate
+[Install]({{ site.baseurl }}/dev-tools/gcc/install/) page.
+
+### Easy install
+
+The easiest way to install GCC is with
+[`xpm`]({{ site.baseurl }}/xpm/)
+by using the **binary xPack**, available as
+[`@xpack-dev-tools/mingw-w64-gcc`](https://www.npmjs.com/package/@xpack-dev-tools/mingw-w64-gcc)
+from the [`npmjs.com`](https://www.npmjs.com) registry.
+
+With the `xpm` tool available, installing
+the latest version of the package and adding it as
+a development dependency for a project is quite easy:
+
+```sh
+cd my-project
+xpm init # Add a package.json if not already present
+
+xpm install @xpack-dev-tools/mingw-w64-gcc@latest --verbose
+
+ls -l xpacks/.bin
+```
+
+To install this specific version, use:
+
+```sh
+xpm install @xpack-dev-tools/mingw-w64-gcc@{{ page.version }}.{{ page.npm_subversion }} --verbose
+```
+
+It is also possible to install Meson Build globally, in the user home folder,
+but this requires xPack aware tools to automatically identify them and
+manage paths.
+
+```sh
+xpm install --global @xpack-dev-tools/mingw-w64-gcc@latest --verbose
+```
+
+### Uninstall
+
+To remove the links created by xpm in the current project:
+
+```sh
+cd my-project
+
+xpm uninstall @xpack-dev-tools/mingw-w64-gcc
+```
+
+To completely remove the package from the central xPack store:
+
+```sh
+xpm uninstall --global @xpack-dev-tools/mingw-w64-gcc
+```
+
+## Compliance
+
+The xPack MinGW-w64 GCC generally follows the official
+[GCC](https://gcc.gnu.org/releases.html) releases.
+
+The current version is based on:
+
+- GCC version [{{ page.gcc_version }}](https://gcc.gnu.org/gcc-{{ page.gcc_version_major }}/) from {{ page.gcc_release_date }};
+- binutils version
+[{{ page.binutils_version }}]({{ page.binutils_release_url }})
+from {{ page.binutils_date }}
+- MinGW-w64 version [{{ page.mingw_release }}](https://sourceforge.net/projects/mingw-w64/files/mingw-w64/mingw-w64-release/)
+
+## Supported languages
+
+The supported languages are:
+
+- C
+- C++
+- Fortran
+- Obj-C
+- Obj-C++
+- Fortran
+
+Note: Obj-C/C++ support is minimalistic.
+
+## Changes
+
+Compared to the upstream, there are no functional changes.
+
+## Bug fixes
+
+- none
+
+## Enhancements
+
+- none
+
+## Known problems
+
+Please see the separate
+[tests results page](/dev-tools/mingw-w64-gcc/tests/11.5.0-1/).
+
+## Shared libraries
+
+On all platforms the packages are standalone, and expect only the standard
+runtime to be present on the host.
+
+All dependencies that are build as shared libraries are copied locally
+in the `libexec` folder (or in the same folder as the executable for Windows).
+
+### `-static-libgcc -static-libstdc++`
+
+To avoid issues with DLLs, specific when using toolchains installed
+in custom locations, it is highly recommended to use only the
+static versions of the GCC libraries.
+
+For C programs, append `-static-libgcc` to the linker line.
+
+For C++ programs, since the toolchain is configured to use POSIX threads,
+instead of `-static-libstdc++`, use the more explicit variant
+`-Wl,-Bstatic,-lstdc++,-lpthread,-Bdynamic` when invoking the linker.
+
+### `DT_RPATH` and `LD_LIBRARY_PATH`
+
+On GNU/Linux the binaries are adjusted to use a relative path:
+
+```console
+$ readelf -d library.so | grep runpath
+ 0x000000000000001d (RPATH)            Library rpath: [$ORIGIN]
+```
+
+In the GNU ld.so search strategy, the `DT_RPATH` has
+the highest priority, higher than `LD_LIBRARY_PATH`, so if this later one
+is set in the environment, it should not interfere with the xPack binaries.
+
+Please note that previous versions, up to mid-2020, used `DT_RUNPATH`, which
+has a priority lower than `LD_LIBRARY_PATH`, and does not tolerate setting
+it in the environment.
+
+### `@rpath` and `@loader_path`
+
+Similarly, on macOS, the binaries are adjusted with `install_name_tool` to use a
+relative path.
+
+## Documentation
+
+To save space and bandwidth, the original GNU GCC documentation is available
+[online](https://gcc.gnu.org/onlinedocs/).
+
+## Build
+
+The binaries for all supported platforms
+(Windows, macOS and GNU/Linux) were built using the
+[xPack Build Box (XBB)](https://xpack.github.io/xbb/), a set
+of build environments based on slightly older distributions, that should be
+compatible with most recent systems.
+
+For the prerequisites and more details on the build procedure, please see the
+[How to build](https://github.com/xpack-dev-tools/mingw-w64-gcc-xpack/blob/xpack/README-BUILD.md) page.
+
+## CI tests
+
+Before publishing, a set of simple tests were performed on an exhaustive
+set of platforms. The results are available from:
+
+- [GitHub Actions](https://github.com/xpack-dev-tools/mingw-w64-gcc-xpack/actions/)
+- [Travis CI](https://app.travis-ci.com/github/xpack-dev-tools/mingw-w64-gcc-xpack/builds/)
+
+## Tests
+
+The binaries were tested on a variety of platforms,
+but mainly to check the integrity of the
+build, not the compiler functionality.
+
+## Checksums
+
+The SHA-256 hashes for the files are:
+
+```txt
+2cb2f7d94d6e7254803f34dc3eb44073c97875771f0a977b4cd583cac5d8e7e3
+xpack-mingw-w64-gcc-11.5.0-1-darwin-arm64.tar.gz
+
+22b003a30e6aa2b4d634ca03c9a6ea9d20062e430854e42f8c6f2a0d03692a21
+xpack-mingw-w64-gcc-11.5.0-1-darwin-x64.tar.gz
+
+748ba586edd7e9c6a6690336e74c2da798f732df991872d399a502cb79f5b0ff
+xpack-mingw-w64-gcc-11.5.0-1-linux-arm.tar.gz
+
+d79cb29d0ab5ade45cf7748cfd0749acd27cc019565eb664a263af6e6e332d9f
+xpack-mingw-w64-gcc-11.5.0-1-linux-arm64.tar.gz
+
+f8eaf420ad20c0f5213b058f004d4e50ab0bbfd4e99c6be2217f9739369f25bf
+xpack-mingw-w64-gcc-11.5.0-1-linux-x64.tar.gz
+
+74df35aa1c68ac73549817cb5dc6e0add312a374f509aac1ecafb3feaaab87c7
+xpack-mingw-w64-gcc-11.5.0-1-win32-x64.zip
+
+```
+
+## Deprecation notices
+
+### Linux minimum requirements
+
+The minimum requirement is **GLIBC 2.27**, available starting
+with Ubuntu 18, Debian 10 and RedHat 8.
+Support for RedHat 7 was dropped in 2022.
+
+### 32-bit support
+
+Support for 32-bit Intel Linux and Intel Windows was
+dropped in 2022.
+
+### Pre-deprecation notice for 32-bit Arm Linux
+
+Due to the large user base of 32-bit Raspberry Pi systems,
+support for 32-bit Arm Linux (armv7l) will be preserved
+for a little while, but expect it to be dropped by 2025,
+so it is recommended to consider an upgrade to a RPi 4 or 5 with
+at least 4 GB (preferably 8 GB) of RAM.
+
+## Pre-deprecation notice for Ubuntu 18.04
+
+Ubuntu 18.04 LTS _Bionic Beaver_ reached the end of the standard five-year
+maintenance window for Long-Term Support (LTS) release on 31 May 2023.
+
+As a courtesy, the xPack GNU/Linux releases will continue to be based on
+Ubuntu 18.04 for another year.
+
+From 2025 onwards, the GNU/Linux binaries will be built on **Debian 10**,
+(**GLIBC 2.28**), and are also expected to run on RedHat 8.
+
+Users are urged to update their build and test infrastructure to
+ensure a smooth transition to the next xPack releases.
+
+## Download analytics
+
+- GitHub [xpack-dev-tools/mingw-w64-gcc-xpack](https://github.com/xpack-dev-tools/mingw-w64-gcc-xpack/)
+  - this release [![Github All Releases](https://img.shields.io/github/downloads/xpack-dev-tools/mingw-w64-gcc-xpack/v{{ page.version }}/total.svg)](https://github.com/xpack-dev-tools/mingw-w64-gcc-xpack/releases/v{{ page.version }}/)
+  - all xPack releases [![Github All Releases](https://img.shields.io/github/downloads/xpack-dev-tools/mingw-w64-gcc-xpack/total.svg)](https://github.com/xpack-dev-tools/mingw-w64-gcc-xpack/releases/)
+  - [individual file counters](https://somsubhra.github.io/github-release-stats/?username=xpack-dev-tools&repository=gcc-xpack) (grouped per release)
+- npmjs.com [@xpack-dev-tools/mingw-w64-gcc](https://www.npmjs.com/package/@xpack-dev-tools/mingw-w64-gcc)
+  - latest releases [![npm](https://img.shields.io/npm/dw/@xpack-dev-tools/mingw-w64-gcc.svg)](https://www.npmjs.com/package/@xpack-dev-tools/mingw-w64-gcc/)
+  - all @xpack-dev-tools releases [![npm](https://img.shields.io/npm/dt/@xpack-dev-tools/mingw-w64-gcc.svg)](https://www.npmjs.com/package/@xpack-dev-tools/mingw-w64-gcc/)
+
+Credit to [Shields IO](https://shields.io) for the badges and to
+[Somsubhra/github-release-stats](https://github.com/Somsubhra/github-release-stats)
+for the individual file counters.