nodejs/deps/uv/SUPPORTED_PLATFORMS.md

69 lines
2.7 KiB
Markdown
Raw Permalink Normal View History

# Supported platforms
| System | Support type | Supported versions | Notes |
|---|---|---|---|
| GNU/Linux | Tier 1 | Linux >= 3.10 with glibc >= 2.17 | |
| macOS | Tier 1 | macOS >= 11 | Currently supported macOS releases |
| Windows | Tier 1 | >= Windows 10 | VS 2015 and later are supported |
| FreeBSD | Tier 2 | >= 12 | |
| AIX | Tier 2 | >= 6 | Maintainers: @libuv/aix |
| IBM i | Tier 2 | >= IBM i 7.2 | Maintainers: @libuv/ibmi |
| z/OS | Tier 2 | >= V2R2 | Maintainers: @libuv/zos |
| Linux with musl | Tier 2 | musl >= 1.0 | |
deps: upgrade to libuv 1.44.2 Notable changes: - Build regression fixes for various platform updates (https://github.com/libuv/libuv/pull/3428, https://github.com/libuv/libuv/pull/3419, https://github.com/libuv/libuv/pull/3423, https://github.com/libuv/libuv/pull/3413, https://github.com/libuv/libuv/pull/3431) - Support for GNU/Hurd (https://github.com/libuv/libuv/pull/3450) - Release tool improvements (https://github.com/libuv/libuv-release-tool/pull/13) - Better performing rw locks on Win32 (https://github.com/libuv/libuv/pull/3383) - Support for posix_spawn API (https://github.com/libuv/libuv/pull/3257) - Fix regression on OpenBSD (https://github.com/libuv/libuv/pull/3506) - Add uv_available_parallelism() (https://github.com/libuv/libuv/pull/3499) - Don't use thread-unsafe strtok() (https://github.com/libuv/libuv/pull/3524) - Fix hang after NOTE_EXIT (https://github.com/libuv/libuv/pull/3521) - Better align order-of-events behavior between platforms (https://github.com/libuv/libuv/pull/3598) - Fix fs event not fired if the watched file is moved/removed/recreated (https://github.com/libuv/libuv/pull/3540) - Fix pipe resource leak if closed during connect (and other bugs) (https://github.com/libuv/libuv/pull/3611) - Don't error when killing a zombie process (https://github.com/libuv/libuv/pull/3625) - Avoid posix_spawnp() cwd bug (https://github.com/libuv/libuv/pull/3597) - Skip EVFILT_PROC events when invalidating events for an fd (https://github.com/libuv/libuv/pull/3629) Fixes: https://github.com/nodejs/node/issues/42290 PR-URL: https://github.com/nodejs/node/pull/42340 Reviewed-By: Michaël Zasso <targos@protonmail.com> Reviewed-By: Juan José Arboleda <soyjuanarbol@gmail.com> Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com> Reviewed-By: Darshan Sen <raisinten@gmail.com> Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
2022-03-15 09:34:01 +01:00
| Android | Tier 3 | NDK >= r15b | Android 7.0, `-DANDROID_PLATFORM=android-24` |
| MinGW | Tier 3 | MinGW-w64 | |
| SunOS | Tier 3 | Solaris 121 and later | |
| Other | Tier 3 | N/A | |
## Support types
* **Tier 1**: Officially supported and tested with CI. Any contributed patch
MUST NOT break such systems. These are supported by @libuv/collaborators.
* **Tier 2**: Officially supported, but not necessarily tested with CI. These
systems are maintained to the best of @libuv/collaborators ability,
without being a top priority.
* **Tier 3**: Community maintained. These systems may inadvertently break and the
community and interested parties are expected to help with the maintenance.
## Adding support for a new platform
**IMPORTANT**: Before attempting to add support for a new platform please open
an issue about it for discussion.
### Unix
I/O handling is abstracted by an internal `uv__io_t` handle. The new platform
will need to implement some of the functions, the prototypes are in
``src/unix/internal.h``.
If the new platform requires extra fields for any handle structure, create a
new include file in ``include/`` with the name ``uv-theplatform.h`` and add
the appropriate defines there.
All functionality related to the new platform must be implemented in its own
file inside ``src/unix/`` unless it's already done in a common file, in which
case adding an `ifdef` is fine.
Two build systems are supported: autotools and cmake. Ideally both need to be
supported, but if one of the two does not support the new platform it can be
left out.
### Windows
Windows is treated as a single platform, so adding support for a new platform
would mean adding support for a new version.
Compilation and runtime must succeed for the minimum supported version. If a
new API is to be used, it must be done optionally, only in supported versions.
### Common
Some common notes when adding support for new platforms:
* Generally libuv tries to avoid compile time checks. Do not add any to the
autotools based build system or use version checking macros.
Dynamically load functions and symbols if they are not supported by the
minimum supported version.