Skip to content

Commit

Permalink
Protocolary updates for release 4.1.13
Browse files Browse the repository at this point in the history
  • Loading branch information
ydahhrk committed Aug 23, 2024
1 parent 75440ae commit 39ca69f
Show file tree
Hide file tree
Showing 10 changed files with 38 additions and 39 deletions.
2 changes: 1 addition & 1 deletion INSTALL
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ See https://nicmx.github.io/Jool/en/install.html

Quick version:

./autogen.sh # If this script does not exist, skip this command.
./autogen.sh # If this script does not exist, skip it.
./configure
make
sudo make install # userspace tools
Expand Down
2 changes: 1 addition & 1 deletion configure.ac
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Process this file with autoconf to produce a configure script.

AC_PREREQ([2.68])
AC_INIT([Jool], [4.1.12], [[email protected]])
AC_INIT([Jool], [4.1.13], [[email protected]])
AC_CONFIG_SRCDIR([src/common/xlat.h])
AM_INIT_AUTOMAKE([subdir-objects])
LT_PREREQ([2.4.6])
Expand Down
2 changes: 1 addition & 1 deletion docs/_config.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
markdown: kramdown
baseurl: /Jool
repository-url: https://github.com/NICMx/Jool
latest-version: 4.1.12
latest-version: 4.1.13

rfc-siit: https://tools.ietf.org/html/rfc7915
draft-siit-eam: https://tools.ietf.org/html/rfc7757
Expand Down
26 changes: 13 additions & 13 deletions docs/en/download.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,26 +12,16 @@ url-dl: https://github.com/NICMx/Jool/releases/download
- Normal font signals recommended fallback versions in case the previous option fails you ([bug reports welcomed]({{ site.repository-url }}/issues)).
- <del>Striked</del> versions are not recommended (either because they're too old or have known critical bugs).

## 4.2.x

Jool 4.2 is a compliant SIIT, Stateful NAT64 and MAP-T.

| Release Date | Version | .tar.gz | .tar.gz Signature | Git commit | .deb |
|--------------|---------|---------|-------------------|------------|------|
| 2021-02-19 | 4.2.0-rc2 | [Download]({{ page.url-dl }}/v4.2.0-rc2/jool-4.2.0.rc2.tar.gz) | [Signature]({{ page.url-dl }}/v4.2.0-rc2/jool-4.2.0.rc2.tar.gz.asc) | <a href="{{ site.repository-url }}/tree/v4.2.0-rc2" target="_blank">Link</a> | [Kernel modules]({{ page.url-dl }}/v4.2.0-rc2/jool-dkms_4.2.0.rc2-1_all.deb)<br />[Userspace tools]({{ page.url-dl }}/v4.2.0-rc2/jool-tools_4.2.0.rc2-1_amd64.deb) (amd64 only) |
| 2020-12-24 | 4.2.0-rc1 | [Download]({{ page.url-dl }}/v4.2.0-rc1/jool-4.2.0.rc1.tar.gz) | [Signature]({{ page.url-dl }}/v4.2.0-rc1/jool-4.2.0.rc1.tar.gz.asc) | <a href="{{ site.repository-url }}/tree/v4.2.0-rc1" target="_blank">Link</a> | [Kernel modules]({{ page.url-dl }}/v4.2.0-rc1/jool-dkms_4.2.0.rc1-1_all.deb)<br />[Userspace tools]({{ page.url-dl }}/v4.2.0-rc1/jool-tools_4.2.0.rc1-1_amd64.deb) (amd64 only) |

"rc" stands for "Release Candidate."

## 4.1.x

Jool 4.1 is a [compliant SIIT and Stateful NAT64](intro-jool.html#compliance).

Currently, 4.1.12 is the most mature version of Jool.
Currently, 4.1.13 is the most mature version of Jool.

| Release Date | Version | .tar.gz | .tar.gz Signature | Git commit | .deb |
|--------------|---------|---------|-------------------|------------|------|
| 2024-06-22 | **4.1.12** | [Download]({{ page.url-dl }}/v4.1.12/jool-4.1.12.tar.gz) | [Signature]({{ page.url-dl }}/v4.1.12/jool-4.1.12.tar.gz.asc) | <a href="{{ site.repository-url }}/tree/v4.1.12" target="_blank">Link</a> | [Kernel modules]({{ page.url-dl }}/v4.1.12/jool-dkms_4.1.12-1_all.deb)<br />[Userspace tools]({{ page.url-dl }}/v4.1.12/jool-tools_4.1.12-1_amd64.deb) (amd64 only) |
| 2024-08-23 | **4.1.13** | [Download]({{ page.url-dl }}/v4.1.13/jool-4.1.13.tar.gz) | [Signature]({{ page.url-dl }}/v4.1.13/jool-4.1.13.tar.gz.asc) | <a href="{{ site.repository-url }}/tree/v4.1.13" target="_blank">Link</a> | [Kernel modules]({{ page.url-dl }}/v4.1.13/jool-dkms_4.1.13-1_all.deb)<br />[Userspace tools]({{ page.url-dl }}/v4.1.13/jool-tools_4.1.13-1_amd64.deb) (amd64 only) |
| 2024-06-22 | 4.1.12 | [Download]({{ page.url-dl }}/v4.1.12/jool-4.1.12.tar.gz) | [Signature]({{ page.url-dl }}/v4.1.12/jool-4.1.12.tar.gz.asc) | <a href="{{ site.repository-url }}/tree/v4.1.12" target="_blank">Link</a> | [Kernel modules]({{ page.url-dl }}/v4.1.12/jool-dkms_4.1.12-1_all.deb)<br />[Userspace tools]({{ page.url-dl }}/v4.1.12/jool-tools_4.1.12-1_amd64.deb) (amd64 only) |
| 2023-12-22 | 4.1.11 | [Download]({{ page.url-dl }}/v4.1.11/jool-4.1.11.tar.gz) | [Signature]({{ page.url-dl }}/v4.1.11/jool-4.1.11.tar.gz.asc) | <a href="{{ site.repository-url }}/tree/v4.1.11" target="_blank">Link</a> | [Kernel modules]({{ page.url-dl }}/v4.1.11/jool-dkms_4.1.11-1_all.deb)<br />[Userspace tools]({{ page.url-dl }}/v4.1.11/jool-tools_4.1.11-1_amd64.deb) (amd64 only) |
| 2023-06-11 | 4.1.10 | [Download]({{ page.url-dl }}/v4.1.10/jool-4.1.10.tar.gz) | [Signature]({{ page.url-dl }}/v4.1.10/jool-4.1.10.tar.gz.asc) | <a href="{{ site.repository-url }}/tree/v4.1.10" target="_blank">Link</a> | [Kernel modules]({{ page.url-dl }}/v4.1.10/jool-dkms_4.1.10-1_all.deb)<br />[Userspace tools]({{ page.url-dl }}/v4.1.10/jool-tools_4.1.10-1_amd64.deb) (amd64 only) |
| 2023-01-25 | 4.1.9 | [Download]({{ page.url-dl }}/v4.1.9/jool-4.1.9.tar.gz) | [Signature]({{ page.url-dl }}/v4.1.9/jool-4.1.9.tar.gz.asc) | <a href="{{ site.repository-url }}/tree/v4.1.9" target="_blank">Link</a> | [Kernel modules]({{ page.url-dl }}/v4.1.9/jool-dkms_4.1.9-1_all.deb)<br />[Userspace tools]({{ page.url-dl }}/v4.1.9/jool-tools_4.1.9-1_amd64.deb) (amd64 only) |
Expand All @@ -47,3 +37,13 @@ Currently, 4.1.12 is the most mature version of Jool.

My public key is on [Github](https://github.com/ydahhrk.gpg).

## 4.2.x

Jool 4.2 is a compliant SIIT, Stateful NAT64 and MAP-T.

| Release Date | Version | .tar.gz | .tar.gz Signature | Git commit | .deb |
|--------------|---------|---------|-------------------|------------|------|
| 2021-02-19 | 4.2.0-rc2 | [Download]({{ page.url-dl }}/v4.2.0-rc2/jool-4.2.0.rc2.tar.gz) | [Signature]({{ page.url-dl }}/v4.2.0-rc2/jool-4.2.0.rc2.tar.gz.asc) | <a href="{{ site.repository-url }}/tree/v4.2.0-rc2" target="_blank">Link</a> | [Kernel modules]({{ page.url-dl }}/v4.2.0-rc2/jool-dkms_4.2.0.rc2-1_all.deb)<br />[Userspace tools]({{ page.url-dl }}/v4.2.0-rc2/jool-tools_4.2.0.rc2-1_amd64.deb) (amd64 only) |
| 2020-12-24 | 4.2.0-rc1 | [Download]({{ page.url-dl }}/v4.2.0-rc1/jool-4.2.0.rc1.tar.gz) | [Signature]({{ page.url-dl }}/v4.2.0-rc1/jool-4.2.0.rc1.tar.gz.asc) | <a href="{{ site.repository-url }}/tree/v4.2.0-rc1" target="_blank">Link</a> | [Kernel modules]({{ page.url-dl }}/v4.2.0-rc1/jool-dkms_4.2.0.rc1-1_all.deb)<br />[Userspace tools]({{ page.url-dl }}/v4.2.0-rc1/jool-tools_4.2.0.rc1-1_amd64.deb) (amd64 only) |

"rc" stands for "Release Candidate."
20 changes: 13 additions & 7 deletions docs/en/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,18 +22,24 @@ Jool is an Open Source [SIIT and NAT64](intro-xlat.html) for Linux.

> ![Warning](../images/warning.svg) The project's development has slowed down to essential maintenance. Bugfixing and support will remain active, but there will be no new features in the foreseeable future.
- The most mature version is [4.1.12](download.html#41x).
- The second release candidate for version [4.2.0](download.html#42x) is also available now.
- The most mature version is [4.1.13](download.html#41x).
- **jool.mx is no longer maintained. Please use https://nicmx.github.io/Jool instead.**

-------------------

## Latest News

### 2024-06-22
### 2024-08-23

Version 4.1.12 has been released. Bugfixes:
Version 4.1.13 has been released. Bugfixes:

- [#410](https://github.com/NICMx/Jool/issues/410): Fix several joold bugs. Also, add [joold stats](config-joold.html#stats-server-port).
- Add [support](intro-jool.html#compatibility) for kernels 6.8, 6.9, 6.10(-rc4), RHEL 8.10 and 9.4. (No changes needed.)
- Patch some rust in the ["graybox" testing framework](https://github.com/NICMx/Jool/tree/main/test/graybox).
- [#410](https://github.com/NICMx/Jool/issues/410):
1. Move `joold` to [`jool session proxy`](usr-flags-session.html#proxy)
2. Move `jool joold advertise` to [`jool session advertise`](usr-flags-session.html#advertise)
- [Debian#1074120](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1074120): Fix implementation of kernel modules' `make distclean`
- [#421](https://github.com/NICMx/Jool/issues/421): [`jool session follow`](usr-flags-session.html#follow)
- [#422](https://github.com/NICMx/Jool/pull/422): Patch compilation on 32-bit architectures
- [e8c49da](https://github.com/NICMx/Jool/commit/e8c49daaa5ae2fc5e75ad4bf7079b815775f1a50): Allow pool6 with prefix length ≠ 96 on joold
- [78812d6](https://github.com/NICMx/Jool/commit/78812d66d5b1b7e3ae767b24a1e12bd9dc5b2eab): Deprecate and no-op `--ss-flush-asap`
- [80760bb](https://github.com/NICMx/Jool/commit/80760bbc6e972cad0ea3ecff7d6452077b0222f4): Stop the userspace client from killing itself when the kernel module sends an unknown stat
- [5150753](https://github.com/NICMx/Jool/commit/51507535de7d621263544237485bed3085ae3643): Drop `XTABLES_DISABLED`. (The kernel module now automatically detects whether the kernel was compiled with xtables support. The userspace client still needs to be told with `./configure --with-xtables=no`.)
15 changes: 4 additions & 11 deletions docs/en/intro-jool.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,19 +48,12 @@ Please [let us know]({{ site.repository-url }}/issues) if you find additional co

| Jool version | Supported Linux kernels (mainline) | Supported Linux kernels (RHEL) |
|-------------------------------------|--------------------------------------|--------------------------------|
| [main]({{ site.repository-url }}),<br />[4.1.12](download.html#41x) | 4.19 - 4.20,<br />5.0 - 5.19,<br />6.0 - 6.10(-rc4) | RHEL 8.9 - 8.10,<br />RHEL 9.0 - 9.4 |
| [main]({{ site.repository-url }}),<br />[4.1.13](download.html#41x) | 5.15 - 5.19&#42;,<br />6.0 - 6.11(-rc2) | RHEL 9.0 - 9.4&#42; |
| [4.1.12](download.html#41x) | 4.19 - 4.20,<br />5.0 - 5.19,<br />6.0 - 6.10 | RHEL 8.9 - 8.10,<br />RHEL 9.0 - 9.4 |
| [4.1.11](download.html#41x) | 4.18 - 4.20,<br />5.0 - 5.19,<br />6.0 - 6.7 | RHEL 8.6 - 8.9,<br />RHEL 9.0 - 9.3 |
| [4.1.10](download.html#41x) | 4.14 - 4.20,<br />5.0 - 5.19,<br />6.0 - 6.3 | RHEL 8.6 - 8.7,<br />RHEL 9.0 - 9.3 |
| [4.1.9](download.html#41x) | 4.9 - 4.20,<br />5.0 - 5.19,<br />6.0 - 6.1 | RHEL 8.6 - 8.7,<br />RHEL 9.0 - 9.1 |
| [4.1.8](download.html#41x) | 4.9 - 4.20,<br />5.0 - 5.16 | RHEL 8.5 |
| [4.1.6](download.html#41x),<br />[4.1.7](download.html#41x) | 4.4 - 4.20,<br />5.0 - 5.15 | RHEL 8.5 |
| [4.1.5](download.html#41x) | 3.16 - 3.19,<br />4.0 - 4.20,<br />5.0 - 5.11 | RHEL 7.6 - RHEL 7.7,<br />RHEL 8.0 |
| [4.1.3](download.html#41x),<br />[4.1.4](download.html#41x) | 3.16 - 3.19,<br />4.0 - 4.20,<br />5.0 - 5.9 | RHEL 7.6 - RHEL 7.7,<br />RHEL 8.0 |
| [4.1.2](download.html#41x) | 3.16 - 3.19,<br />4.0 - 4.20,<br />5.0 - 5.7 | RHEL 7.6 - RHEL 7.7,<br />RHEL 8.0 |
| [4.1.1](download.html#41x),<br />[4.1.0](download.html#41x) | 3.16 - 3.19,<br />4.0 - 4.20,<br />5.0 - 5.7 | RHEL 7.6 - RHEL 7.7,<br /><del>[RHEL 8.0](https://github.com/NICMx/Jool/issues/334)</del> |
| [4.0.9](download.html#40x) | 3.13 - 3.19,<br />4.0 - 4.20,<br />5.0 - 5.6 | RHEL 7.0 - RHEL 7.7,<br /><del>[RHEL 8.0](https://github.com/NICMx/Jool/issues/334)</del> |
| [4.0.8](download.html#40x) | 3.13 - 3.19,<br />4.0 - 4.20,<br />5.0 - 5.5 | RHEL 7.0 - RHEL 7.7,<br /><del>[RHEL 8.0](https://github.com/NICMx/Jool/issues/334)</del> |
| [4.0.7](download.html#40x) | 3.13 - 3.19,<br />4.0 - 4.20,<br />5.0 - 5.4 | RHEL 7.0 - RHEL 7.7,<br /><del>[RHEL 8.0](https://github.com/NICMx/Jool/issues/334)</del> |

If you're using a non-RHEL distribution (eg. Debian derivatives), execute `uname -r` to print the kernel version you're running. Suffixes rarely matter. Here's an example from my running machine, which states that my running kernel is 4.15:

Expand All @@ -69,12 +62,12 @@ If you're using a non-RHEL distribution (eg. Debian derivatives), execute `uname

RHEL-based distributions (such as Red Hat and CentOS) do not follow the normal kernel versioning conventions; use the third column instead.

&#42; Jool 4.1.13 still probably compiles and runs fine in kernels 4.19 to 5.14 (and RHEL 8), but I have lost the ability to test them to the merciless and everlasting ravage of entropy. If you're interested in any particular kernel, try running the test suite yourself: [1](https://github.com/NICMx/Jool/tree/main/test/unit), [2](https://github.com/NICMx/Jool/tree/main/test/graybox).

## Design

A Jool instance can be attached to one of two different traffic-intercepting, plugin-enabling, kernel-based frameworks: _Netfilter_ and _iptables_. Despite some documentation out there, these two are not the same thing; at least not from Jool's point of view.

> ![Note!](../images/bulb.svg) Yes, we know we're supposed to add nftables support, but it's going to be a lot of work, and so it's tentatively scheduled to come out in late 2021.
### Netfilter

_Netfilter_ is a bunch of [hooks](http://www.netfilter.org/documentation/HOWTO/netfilter-hacking-HOWTO-3.html) (`PREROUTING`, `LOCALIN`, `FORWARD`, `LOCALOUT` and `POSTROUTING`) in the Linux kernel where modules can inject code. Whenever a packet reaches a hook, the kernel runs it through all the corresponding registered modules. Netfilter Jool instances hook themselves to `PREROUTING` and as such intercept all incoming traffic ("pre"vious to "routing") with the intent of translating it.
Expand Down
4 changes: 2 additions & 2 deletions src/common/xlat.h
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@
*/
#define JOOL_VERSION_MAJOR 4
#define JOOL_VERSION_MINOR 1
#define JOOL_VERSION_REV 12
#define JOOL_VERSION_DEV 1
#define JOOL_VERSION_REV 13
#define JOOL_VERSION_DEV 0

/** See http://stackoverflow.com/questions/195975 */
#define STR_VALUE(arg) #arg
Expand Down
2 changes: 1 addition & 1 deletion src/usr/joold/joold.8
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.\" Manpage for jool's session synchronization daemon.

.TH joold 8 2024-06-22 v4.1.12 "NAT64 Jool's Session Synchronization Daemon"
.TH joold 8 2024-08-23 v4.1.13 "NAT64 Jool's Session Synchronization Daemon"

.SH NAME
joold - Userspace Session Synchronization (SS) daemon for NAT64 Jool.
Expand Down
2 changes: 1 addition & 1 deletion src/usr/nat64/jool.8
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.\" Manpage for jool's userspace app.

.TH jool 8 2024-06-22 v4.1.12 "NAT64 Jool's Userspace Client"
.TH jool 8 2024-08-23 v4.1.13 "NAT64 Jool's Userspace Client"

.SH NAME
jool - Interact with NAT64 Jool (the kernel module).
Expand Down
2 changes: 1 addition & 1 deletion src/usr/siit/jool_siit.8
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.\" Manpage for jool's userspace app.

.TH jool_siit 8 2024-06-22 v4.1.12 "SIIT Jool's Userspace Client"
.TH jool_siit 8 2024-08-23 v4.1.13 "SIIT Jool's Userspace Client"

.SH NAME
jool_siit - Interact with SIIT Jool (the kernel module).
Expand Down

0 comments on commit 39ca69f

Please sign in to comment.