Skip to content

Commit

Permalink
Merge pull request #3722 from citrus-it/r52rn
Browse files Browse the repository at this point in the history
Prepare release notes for r151052
  • Loading branch information
hadfl authored Nov 2, 2024
2 parents dde024f + 2a0b3bf commit 914fa0a
Showing 1 changed file with 297 additions and 13 deletions.
310 changes: 297 additions & 13 deletions doc/ReleaseNotes.md
Original file line number Diff line number Diff line change
@@ -1,51 +1,259 @@
<a href="https://omnios.org">
<img src="https://omnios.org/OmniOSce_logo.svg" height="128">
<img src="https://omnios.org/OmniOSce_logo.svg" height="130">
</a>

# Release Notes for OmniOSce v11 r1510XX
# Release Notes for OmniOSce v11 r151052

+## $\color{red}{\textit{These are DRAFT release notes}}$
Stable Release, 4th of Nov 2024

Stable `?and Long-Term-Supported (LTS)?` Release, TBC of May/Nov 20XX
`uname -a` shows `omnios-r151052-dbe4644ba92`

`uname -a` shows `omnios-r1510XX-XXX`

r1510XX release repository: https://pkg.omnios.org/r1510XX/core
r151052 release repository: https://pkg.omnios.org/r151052/core

## Upgrade Notes

Upgrades are supported from the r1510... releases
Upgrades are supported from the r151046, r151048 and r151050 releases
only. If upgrading from an earlier version, upgrade in stages, referring to the
table at <https://omnios.org/upgrade>.

## New features since r1510XX
## New features since r151050

### System Features

* It is now possible for the `cpqary3` and `smrt` drivers to co-exist on a
system, and to switch devices which are supported by both over to using
the newer `smrt`. This is done by changing a variant to enable the device
aliases in the smrt driver. This can be done as a single step in a new
temporarily activated boot environment (to allow easy rollback) with
something like:
```bash
pkg change-variant --be-name=smrt --temp-be-activate smrt.aliases=true
init 6
```

* OpenSSL 3 now has support for the
[open-quantum-safe](https://openquantumsafe.org/) provider.

* SMF services which start as root and user to have their initial working
directory set to root's home directory (`/root`) now start in `/`. This
allows `/root` to be a separate ZFS dataset.

* Some services which can only partially succeed can now enter the degraded
state where they will not block dependencies from coming online. For example,
the service which mounts all filesystems during boot will enter this state if
any filesystem fails to mount, but dependencies such as the ssh service can
still start, allowing easier access to resolve the problem.

* The encryption feature in SMB3 is now supported by the SMB client.

### Commands and Command Options

* [`false(1)`](https://man.omnios.org/man1/false) no longer exits with a status
of 255. While previously allowed by POSIX, the latest standard prohibits
any exit status over 128, and some external software goes further and expects
this to be exactly `1`. Such (incorrect) software will now be sated.

* The `rsync` command now supports IPv6.

* `cp` and `mv` now support the `-n` option.

* `ln` now supports `-i`.

* The `base32` command has been added to the `gnu-coreutils` package.

* [`smbadm`](https://man.omnios.org/smbadm) has grown a new `-s` option to
display SIDs instead of names when enumerating group memberships.

* The [find(1)](https://man.omnios.org/find) command now supports selecting
files via SID.

* [ptree(1)](https://man.omnios.org/ptree) with the `-g` option is now more
willing to use UTF-8 box characters.

* system/library/mozilla-nss now includes the NSS test client (`tstclnt`).

* The fault management `fmdump` utility has been updated to support more
complex property filters and the [man page](https://man.omnios.org/fmdump)
has been expanded to document options such as -A, -a, -H, -j and -p.

* [nc(1)](https://man.omnios.org/nc) now supports options to set the
outgoing and minimum TTL, to add a traffic class for IPv6 sockets, and
to enable TCP MD5.

* [savecore(8)](https://man.omnios.org/savecore) now reports progress whilst
saving compressed dumps.

* [diskinfo(8)](https://man.omnios.org/diskinfo) shows disk serial numbers
in more cases.

* The [pwdx(1)](https://man.omnios.org/pwdx) command can now be used on
core files.

* [dumpadm(8)](https://man.omnios.org/dumpadm) has new `-H` and `-p` flags for
parsable output.

* [nvmeadm(8)](https://man.omnios.org/nvmeadm) has been extended to support
more device/vendor-specific commands, and with commands to access a drive's
persistent event log.

* `cxgbetool` now supported general register reads and writes.

* mdb's `disk_label mbr` command now includes details of the BIOS parameter
block in its output.

### Libraries and Library Functions

* Support for `FD_CLOFORK` (an `FD_CLOEXEC` analogue) and related features
has been added. illumos [issue 16624](https://www.illumos.org/issues/16624)
has further details.

* A number of new functions for specifying a particular clock type when
phrasing an absolute timeout with mutex, condition variable and rwlock
functions have been added -- see
[pthread_mutex_clocklock(3C)](https://man.omnios.org/pthread_mutex_clocklock),
[pthread_rwlock_clockwrlock(3C)](https://man.omnios.org/pthread_rwlock_clockwrlock),
[pthread_rwlock_clockrdlock(3C)](https://man.omnios.org/pthread_rwlock_timedrdlock),
[pthread_cond_clockwait(3C)](https://man.omnios.org/pthread_cond_clockwait).

* [syncfs(3C)](https://man.omnios.org/syncfs) has been added.

* New `strerrordesc_np` and `strerrnorname_np` functions - see
[strerror(3C)](https://man.omnios.org/strerror).

* [pts_name_r(3C)](https://man.omnios.org/ptsname_r) is now available.

* Support for decoding SMBIOS additional information (type 40) records.

* libjedec has been enhanced with support for LPDDR3-5, DDR5 and newer
versions of the specification.

### Networking

* The `IP_MINTTL` and `IPV6_MINHOPCOUNT` socket options are now supported for
IPv4 and IPv6 (respectively) TCP, UDP, SCTP, and raw IP sockets.

* The `TCP_MD5SIG` option is now supported. This is commonly used as an
additional authentication layer for BGP connections. This is configured
via the new [tcpkey(8)](https://man.omnios.org/tcpkey) utility and a
persistent configuration can be placed in `/etc/inet/secret/tcpkeys`. There
is a new `Network TCP Key Management` rights profile that enables running
`tcpkey` via `pfexec`, and to manage the tcpkey service.

* The `SO_SNDTIMEO` and `SO_RCVTIMEO` options were broken for UNIX domain
sockets. This has been rectified.

* The `SO_PROTOCOL` socket option is now defined. This is the POSIX name for
the pre-existing `SO_PROTOTYPE`.

* It is now possible to provide a MAC address via `dladm` when creating a
simnet.

### Zones

### LX zones

* Support for simple (covering whole file) OFD locks has been added.

* The `TCP_INFO` socket option is no longer permitted on UNIX domain sockets.

### Bhyve

* If necessary, bhyve can be started without enabling the BARS in guest PCI
devices. This is not generally what you want but can be useful for (exotic)
guests that do not expect the hypervisor to have done this.

### ZFS

* ZFS now includes optimised fletcher-4 checksum implementations that can take
advantage of SSE / AVX2 / AVX-512.

* Reference count tracking (used when debugging ZFS) has been switched from
using lists to AVL trees, significantly reducing the overhead of having it
enabled.

* The `::zfs_dbgmsg` kmdb command now supports new `-t` and `-T` options for
displaying times alongside messages from the log ringbuffer.

### Package Management

* A synthetic `pkg.fmri.name` attribute is now available to IPS transforms.
This is the name of the package, without any scheme, publisher name or
version information, e.g. `library/libxml2`.

### Hardware Support

### Installer
* Initial support for AMD Turin and the Zen 5 micro-architecture.

* Support for the Broadcom / LSI Fusion-MPT SAS38xx cards has been added to the
`mpt_sas` driver.

* Improved support for PCI(e) UART devices with higher baud rates and larger
FIFOs.

* The `cxgbe` firmware bundled in the driver has been updated to version
1.27.5.0

* Several improvements have been made to the NVMe firmware update process
via nvmeadm / libnvme.

* The `nvme` driver has better tracking of admin commands issued to NVMe
controllers and will take account of queue depth when considering whether
commands have timed out. There are also some additional kstats for each
NVMe device that show latency across several command groups. Internal driver
counters have also been promoted to kstats.

* It is now possible to disable a `cxgbe` chip's internal parser to allow
L2/L3 encapsulations not supported by the ASIC. This is done via the new
`CPL_TX_PKT_XT` opcode.

### Virtualisation

* The number of network adapters that can be added to a bhyve VM has been
increased from 8 to 16.

* The `viona` networking driver now has kstats for various statistics.

* When running as a guest, OmniOS is now more willing to use clock information
from the hypervisor. This improves compatibility with recent AWS instance
types.

### Developer Features

* The `_XOPEN_SOURCE` macro value is no longer ignored in the presence of
`__XOPEN_SOURCE_EXTENDED`. This helps when building third party software
that sets the latter variable.

* The GCC 14 compiler is available and used by default to build OmniOS
userland. This compiler contains the patches from the
[illumos gcc-14.2.0-il-1 tag](https://github.com/illumos/gcc/tree/il-14_2_0)

* GCC 10 has been updated with the latest set of illumos-specific patches.

* Both gcc10 and gcc14 now support the use of `%j` and `%z` in the kernel,
support for which was added in
[illumos 16768](https://www.illumos.org/issues/16768).

* GCC 12 has been retired. The package will remain installed if you are
upgrading from a previous version, but will receive no more updates.

* An illumos C style guide is now provided as
[a man page](https://man.omnios.org/style).

* SMF services can enter a degraded state via their exit value, or be marked
as degraded by another service. This allows services to flag themselves for
administrator intervention without blocking all dependent services from
starting.

* A kernel test framework is available, allowing easier development of
tests in kernel code. See [ktest(9)](https://man.omnios.org/man9/ktest) for
more information.

### Deprecated features

* The `/usr/share/pci.ids` file is no longer shipped and the associated
package (system/pciutils/pci.ids) is obsolete. This file was a duplicate of
`/usr/share/hwdata/pci.ids` which should be used instead.

* The `grub` boot loader is deprecated and has been removed in the r151048
release. It will be supported in r151046 for the full LTS time frame, up to
May 2026. If you have not yet migrated to the new boot loader, and would like
Expand All @@ -62,8 +270,84 @@ table at <https://omnios.org/upgrade>.
`python-27` package is still available for backwards compatibility but will
be maintained only on a best-efforts basis.

* OpenSSH in OmniOS no longer provides support for GSSAPI key exchange.
This was removed in release r151038.

### Package changes

| Package | Old Version | New Version |
| :------ | :---------- | :---------- |
| compress/lz4 | 1.9.4 | 1.10.0
| compress/zstd | 1.5.5 | 1.5.6
| data/iso-codes | 4.16.0 | 4.17.0
| database/sqlite-3 | 3.45.2 | 3.46.1
| developer/build/automake | 1.16.5 | 1.17
| ~~developer/gcc12~~ | 12.3.0 | _Removed_
| developer/gcc13 | 13.2.0 | 13.3.0
| **developer/gcc14** | _New_ | 14.2.0
| developer/gnu-binutils | 2.42 | 2.43.1
| developer/macro/cpp | 20220808 | 20240422
| developer/nasm | 2.16.1 | 2.16.3
| developer/versioning/git | 2.44.2 | 2.46.2
| developer/versioning/mercurial | 6.7 | 6.8.1
| **driver/ktest** | _New_ | 0.5.11
| editor/vim | 9.0.2136 | 9.1.652
| file/gnu-coreutils | 9.4 | 9.5
| file/gnu-findutils | 4.9.0 | 4.10.0
| library/glib2 | 2.80.0 | 2.82.1
| library/libxml2 | 2.12.6 | 2.13.4
| library/libxslt | 1.1.30 | 1.1.42
| library/ncurses | 6.4.20240309 | 6.5.20240511
| library/nghttp2 | 1.60.0 | 1.63.0
| library/pcre2 | 10.43 | 10.44
| library/python-3/attrs-312 | 23.2.0 | 24.2.0
| library/python-3/cffi-312 | 1.16.0 | 1.17.0
| library/python-3/coverage-312 | 7.4.3 | 7.6.1
| library/python-3/cryptography-312 | 42.0.5 | 43.0.0
| library/python-3/idna-312 | 3.6 | 3.7
| library/python-3/jsonrpclib-312 | 0.4.3.2 | 0.4.3.3
| library/python-3/meson-312 | 1.4.0 | 1.5.1
| library/python-3/orjson-312 | 3.9.15 | 3.10.7
| library/python-3/packaging-312 | 24.0 | 24.1
| library/python-3/pip-312 | 24.0 | 24.2
| library/python-3/pycodestyle-312 | 2.11.1 | 2.12.1
| library/python-3/pycparser-312 | 2.21 | 2.22
| library/python-3/pyopenssl-312 | 24.1.0 | 24.2.1
| library/python-3/pyyaml-312 | 6.0.1 | 6.0.2
| library/python-3/rapidjson-312 | 1.16 | 1.20
| library/python-3/setuptools-312 | 69.1.1 | 73.0.1
| library/python-3/setuptools-rust-312 | 1.9.0 | 1.10.1
| library/python-3/typing-extensions-312 | 4.10.0 | 4.12.2
| library/readline | 8.2 | 8.2.13
| **library/security/liboqs** | _New_ | 0.10.1
| library/security/openssl | 3.1.7 | 3.3.2
| library/security/openssl-3 | 3.1.7 | 3.3.2
| **library/security/oqs-provider** | _New_ | 0.6.0
| network/dns/bind | 9.18.24 | 9.18.30
| network/openssh | 9.7.1 | 9.9.1
| network/openssh-server | 9.7.1 | 9.9.1
| network/rsync | 3.2.7 | 3.3.0
| network/socat | 1.8.0.0 | 1.8.0.1
| network/test/iperf | 3.1.3 | 3.17.1
| runtime/perl | 5.38.2 | 5.40.0
| runtime/python-312 | 3.12.6 | 3.12.7
| security/sudo | 1.9.15.5 | 1.9.16
| shell/bash | 5.2.26 | 5.2.32
| shell/pipe-viewer | 1.8.5 | 1.8.14
| shell/tcsh | 6.24.11 | 6.24.13
| system/library/g++-runtime | 13 | 14
| system/library/gcc-runtime | 13 | 14
| system/library/gfortran-runtime | 13 | 14
| system/library/gobjc-runtime | 13 | 14
| system/library/mozilla-nss | 3.99 | 3.105
| system/library/pcap | 1.10.4 | 1.10.5
| system/pciutils | 3.11.1 | 3.13.0
| ~~system/pciutils/pci.ids~~ | 2.2.20240331 | _Removed_
| system/rsyslog | 8.2402.0 | 8.2408.0
| **system/test/epolltest** | _New_ | 20240808
| system/test/fio | 3.36 | 3.37
| **system/test/libproctest** | _New_ | 0.5.11
| **system/test/libsectest** | _New_ | 0.5.11
| system/virtualization/open-vm-tools | 12.3.5 | 12.4.5
| terminal/tmux | 3.4 | 3.5
| text/gawk | 5.3.0 | 5.3.1
| text/less | 643 | 661
| web/curl | 8.9.1 | 8.10.1

0 comments on commit 914fa0a

Please sign in to comment.