BIRD 3.1.1 and 3.0.3 released
Dear BIRD users, we are releasing BIRD versions 3.1.1 and 3.0.3. We have fixed BGP route refresh in both versions, and also several build issues on FreeBSD, NetBSD, and CentOS 7. We added several table export fixes to 3.1.1 which were already included in 3.0.2. We fixed several other minor bugs and rare crashes as well. Release tarballs are available on our website <https://bird.nic.cz/get-bird>. Debian and Ubuntu packages are available in our repository at <https://pkg.labs.nic.cz/doc?project=bird>. You may have noticed that the person tagging the version and sending this e-mail has changed. There is also a change in the website URL. I'll send a full e-mail summarizing the organizational changes during the next week. Happy routing! Maria, with Ondrej's approval -- Maria Matejka (she/her) | BIRD Team Leader | CZ.NIC, z.s.p.o.
This is great news! Thanks to everyone involved. I'm still waiting for the funny stories about this refactoring from v2 to v3... And I have a suggestion! A sort of comparison table of functionalities and features between the versions. I believe that I and perhaps some of the other colleagues here on the list, who even though they are not directly involved in the project, have an idea of what the differences are between v2 and v3. But there is still a lot we don't know. Something more on the side of "project promotion" than technical thing. - Does it change syntax? Where? How much? - SMP, of course. - What else? - Who should be using it? Another question I have and may be shared by other colleagues: What is the difference between v3.0 and v3.1? What are the plans for this type of release? Em sex., 16 de mai. de 2025 às 08:30, Maria Matejka via Bird-users < bird-users@network.cz> escreveu:
Dear BIRD users,
we are releasing BIRD versions 3.1.1 and 3.0.3.
We have fixed BGP route refresh in both versions, and also several build issues on FreeBSD, NetBSD, and CentOS 7. We added several table export fixes to 3.1.1 which were already included in 3.0.2. We fixed several other minor bugs and rare crashes as well.
Release tarballs are available on our website https://bird.nic.cz/get-bird. Debian and Ubuntu packages are available in our repository at https://pkg.labs.nic.cz/doc?project=bird.
You may have noticed that the person tagging the version and sending this e-mail has changed. There is also a change in the website URL. I’ll send a full e-mail summarizing the organizational changes during the next week.
Happy routing! Maria, with Ondrej’s approval
– Maria Matejka (she/her) | BIRD Team Leader | CZ.NIC, z.s.p.o.
-- Douglas Fernando Fischer Engº de Controle e Automação
Hello Douglas,
I'm still waiting for the funny stories about this refactoring from v2 to v3...
Will happen, eventually, don't worry 🙃
And I have a suggestion!
A sort of comparison table of functionalities and features between the versions.
Here you are. https://gitlab.nic.cz/labs/bird/-/blob/v3.1.1/doc/migration-bird3.md
- Does it change syntax? Where? How much?
Not in conf, unless you do some low level table performance knobbing.
- SMP, of course. - What else?
Partial route reimports and reexports on ROA updates, not much more iirc.
- Who should be using it?
We are going to stop adding new features into BIRD 2 in some time, as BIRD 3 brings better refactored internal data structures.
Another question I have and may be shared by other colleagues: What is the difference between v3.0 and v3.1? What are the plans for this type of release?
BIRD 3.1 NEWS file gives exactly this information: o CLI v2 compatibility layer for show route o Thread configuration rework o Merged 2.17 Version 2.17 (2025-04-01) o Babel: next hop control for IPv4 o BGP: link-local next hop format configuration o TCP-AO implementation for Linux Have a nice day! Maria -- Maria Matejka (she/her) | BIRD Team Leader | CZ.NIC, z.s.p.o.
Dear Douglas, that's a great idea! Thank you for the suggestion. We will consider promoting it in a more accessible way. In the meantime, you will find some relevant information in our repository. Differences between v2 and v3: https://gitlab.nic.cz/labs/bird/-/blob/thread-next/doc/migration-bird3.md?re... Changes for each v3 release list (including v3.1 also): https://gitlab.nic.cz/labs/bird/-/blob/thread-next/NEWS?ref_type=heads These news items are also newly available on our new website: https://bird.nic.cz/news/ In general, all the v2 functionality should be included in v3, as we continue to merge v2 changes and fixes into v3. If you notice otherwise, please let us know, as it may be a bug. The difference between versions 3.0 and 3.1 is as follows: Bird 3.0 is the first official release of BIRD 3 and will include long-term fixes, so updates will be released for v3.0.x. Versions 3.1 and any future 3.x versions will include new features and functionality. I hope this helps. We will consider improving the presentation of this information, so thank you for your input. P.S. Maria has just responded to this. I hope my information is useful as well! Happy routing! Jana Jana Babovakova (she/her) | BIRD Tech Support | CZ.NIC, z.s.p.o. On 16. 05. 25 14:04, Douglas Fischer wrote:
This is great news! Thanks to everyone involved.
I'm still waiting for the funny stories about this refactoring from v2 to v3...
And I have a suggestion!
A sort of comparison table of functionalities and features between the versions.
I believe that I and perhaps some of the other colleagues here on the list, who even though they are not directly involved in the project, have an idea of what the differences are between v2 and v3. But there is still a lot we don't know. Something more on the side of "project promotion" than technical thing. - Does it change syntax? Where? How much? - SMP, of course. - What else? - Who should be using it?
Another question I have and may be shared by other colleagues: What is the difference between v3.0 and v3.1? What are the plans for this type of release?
Em sex., 16 de mai. de 2025 às 08:30, Maria Matejka via Bird-users < bird-users@network.cz> escreveu:
Dear BIRD users,
we are releasing BIRD versions 3.1.1 and 3.0.3.
We have fixed BGP route refresh in both versions, and also several build issues on FreeBSD, NetBSD, and CentOS 7. We added several table export fixes to 3.1.1 which were already included in 3.0.2. We fixed several other minor bugs and rare crashes as well.
Release tarballs are available on our websitehttps://bird.nic.cz/get-bird. Debian and Ubuntu packages are available in our repository at https://pkg.labs.nic.cz/doc?project=bird.
You may have noticed that the person tagging the version and sending this e-mail has changed. There is also a change in the website URL. I’ll send a full e-mail summarizing the organizational changes during the next week.
Happy routing! Maria, with Ondrej’s approval
– Maria Matejka (she/her) | BIRD Team Leader | CZ.NIC, z.s.p.o.
Thank you, Maria and Jana! Where do I find more information about "CLI v2"? Em sex., 16 de mai. de 2025 às 10:36, Jana Babovakova via Bird-users < bird-users@network.cz> escreveu:
Dear Douglas,
that's a great idea! Thank you for the suggestion. We will consider promoting it in a more accessible way.
In the meantime, you will find some relevant information in our repository.
Differences between v2 and v3:
https://gitlab.nic.cz/labs/bird/-/blob/thread-next/doc/migration-bird3.md?re...
Changes for each v3 release list (including v3.1 also): https://gitlab.nic.cz/labs/bird/-/blob/thread-next/NEWS?ref_type=heads
These news items are also newly available on our new website: https://bird.nic.cz/news/
In general, all the v2 functionality should be included in v3, as we continue to merge v2 changes and fixes into v3. If you notice otherwise, please let us know, as it may be a bug.
The difference between versions 3.0 and 3.1 is as follows: Bird 3.0 is the first official release of BIRD 3 and will include long-term fixes, so updates will be released for v3.0.x. Versions 3.1 and any future 3.x versions will include new features and functionality.
I hope this helps. We will consider improving the presentation of this information, so thank you for your input.
P.S. Maria has just responded to this. I hope my information is useful as well!
Happy routing! Jana
Jana Babovakova (she/her) | BIRD Tech Support | CZ.NIC, z.s.p.o.
On 16. 05. 25 14:04, Douglas Fischer wrote:
This is great news! Thanks to everyone involved.
I'm still waiting for the funny stories about this refactoring from v2 to v3...
And I have a suggestion!
A sort of comparison table of functionalities and features between the versions.
I believe that I and perhaps some of the other colleagues here on the list, who even though they are not directly involved in the project, have an idea of what the differences are between v2 and v3. But there is still a lot we don't know. Something more on the side of "project promotion" than technical thing. - Does it change syntax? Where? How much? - SMP, of course. - What else? - Who should be using it?
Another question I have and may be shared by other colleagues: What is the difference between v3.0 and v3.1? What are the plans for this type of release?
Em sex., 16 de mai. de 2025 às 08:30, Maria Matejka via Bird-users <bird-users@network.cz> escreveu:
Dear BIRD users,
we are releasing BIRD versions 3.1.1 and 3.0.3.
We have fixed BGP route refresh in both versions, and also several build issues on FreeBSD, NetBSD, and CentOS 7. We added several table export fixes to 3.1.1 which were already included in 3.0.2. We fixed several other minor bugs and rare crashes as well.
Release tarballs are available on our website https://bird.nic.cz/get-bird. Debian and Ubuntu packages are available in our repository athttps://pkg.labs.nic.cz/doc?project=bird.
You may have noticed that the person tagging the version and sending this e-mail has changed. There is also a change in the website URL. I’ll send a full e-mail summarizing the organizational changes during the next week.
Happy routing! Maria, with Ondrej’s approval
– Maria Matejka (she/her) | BIRD Team Leader | CZ.NIC, z.s.p.o.
-- Douglas Fernando Fischer Engº de Controle e Automação
Dear Douglas. Let's check the BIRD 2 documentation, also on our new website: https://bird.nic.cz/doc/bird-2.17.1.html#remote-control Let me know, if you need anything more. Happy routing! Jana Jana Babovakova (she/her) | BIRD Tech Support | CZ.NIC, z.s.p.o. On 16. 05. 25 17:58, Douglas Fischer wrote:
Thank you, Maria and Jana!
Where do I find more information about "CLI v2"?
Em sex., 16 de mai. de 2025 às 10:36, Jana Babovakova via Bird-users < bird-users@network.cz> escreveu:
Dear Douglas,
that's a great idea! Thank you for the suggestion. We will consider promoting it in a more accessible way.
In the meantime, you will find some relevant information in our repository.
Differences between v2 and v3:
https://gitlab.nic.cz/labs/bird/-/blob/thread-next/doc/migration-bird3.md?re...
Changes for each v3 release list (including v3.1 also): https://gitlab.nic.cz/labs/bird/-/blob/thread-next/NEWS?ref_type=heads
These news items are also newly available on our new website: https://bird.nic.cz/news/
In general, all the v2 functionality should be included in v3, as we continue to merge v2 changes and fixes into v3. If you notice otherwise, please let us know, as it may be a bug.
The difference between versions 3.0 and 3.1 is as follows: Bird 3.0 is the first official release of BIRD 3 and will include long-term fixes, so updates will be released for v3.0.x. Versions 3.1 and any future 3.x versions will include new features and functionality.
I hope this helps. We will consider improving the presentation of this information, so thank you for your input.
P.S. Maria has just responded to this. I hope my information is useful as well!
Happy routing! Jana
Jana Babovakova (she/her) | BIRD Tech Support | CZ.NIC, z.s.p.o.
On 16. 05. 25 14:04, Douglas Fischer wrote:
This is great news! Thanks to everyone involved.
I'm still waiting for the funny stories about this refactoring from v2 to v3...
And I have a suggestion!
A sort of comparison table of functionalities and features between the versions.
I believe that I and perhaps some of the other colleagues here on the list, who even though they are not directly involved in the project, have an idea of what the differences are between v2 and v3. But there is still a lot we don't know. Something more on the side of "project promotion" than technical thing. - Does it change syntax? Where? How much? - SMP, of course. - What else? - Who should be using it?
Another question I have and may be shared by other colleagues: What is the difference between v3.0 and v3.1? What are the plans for this type of release?
Em sex., 16 de mai. de 2025 às 08:30, Maria Matejka via Bird-users<bird-users@network.cz> escreveu:
Dear BIRD users,
we are releasing BIRD versions 3.1.1 and 3.0.3.
We have fixed BGP route refresh in both versions, and also several build issues on FreeBSD, NetBSD, and CentOS 7. We added several table export fixes to 3.1.1 which were already included in 3.0.2. We fixed several other minor bugs and rare crashes as well.
Release tarballs are available on our websitehttps://bird.nic.cz/get-bird. Debian and Ubuntu packages are available in our repository athttps://pkg.labs.nic.cz/doc?project=bird.
You may have noticed that the person tagging the version and sending this e-mail has changed. There is also a change in the website URL. I’ll send a full e-mail summarizing the organizational changes during the next week.
Happy routing! Maria, with Ondrej’s approval
– Maria Matejka (she/her) | BIRD Team Leader | CZ.NIC, z.s.p.o.
W dniu 16.05.2025 o 13:27, Maria Matejka via Bird-users pisze:
Dear BIRD users,
we are releasing BIRD versions 3.1.1 and 3.0.3.
We have fixed BGP route refresh in both versions, and also several build issues on FreeBSD, NetBSD, and CentOS 7. We added several table export fixes to 3.1.1 which were already included in 3.0.2. We fixed several other minor bugs and rare crashes as well.
Release tarballs are available on our website https://bird.nic.cz/get-bird <https://bird.nic.cz/get-bird>. Debian and Ubuntu packages are available in our repository at https://pkg.labs.nic.cz/doc?project=bird <https://pkg.labs.nic.cz/doc?project=bird>.
You may have noticed that the person tagging the version and sending this e-mail has changed. There is also a change in the website URL. I’ll send a full e-mail summarizing the organizational changes during the next week.
Happy routing! Maria, with Ondrej’s approval
– Maria Matejka (she/her) | BIRD Team Leader | CZ.NIC, z.s.p.o.
Thank you, especially for fixing this FreeBSD Netlink build issue. I am testing on FreeBSD. So far so good. One remark: perhaps source files could be published also in old repo: https://bird.network.cz/download/ Cheers -- Marek Zarychta
Hello Marek,
we are releasing BIRD versions 3.1.1 and 3.0.3.
We have fixed BGP route refresh in both versions, and also several build issues on FreeBSD, NetBSD, and CentOS 7. We added several table export fixes to 3.1.1 which were already included in 3.0.2. We fixed several other minor bugs and rare crashes as well.
Thank you, especially for fixing this FreeBSD Netlink build issue. I am testing on FreeBSD. So far so good.
Thanks for confirming! We had several issues with running different flavors of BSD for our CI, yet after Ondřej Zajíček resolved that, we now finally have automatic build tests covering also FreeBSD with Netlink, so that no further oversights should happen in merging or refactoring.
One remark: perhaps source files could be published also in old repo: https://bird.network.cz/download/
If I remember correctly, this link should in future also redirect to the new one, we just haven't had enough devops time to fix everything at once. More on that in the organizational announcement later. Yet, thanks for pointing this out. Have a nice weekend! Maria -- Maria Matejka (she/her) | BIRD Team Leader | CZ.NIC, z.s.p.o.
Hi all, just wanted to report shortly that i'm hitting some sort of regression with 3.1.1 as well as 3.0.3. May 27 22:51:38 gw07 systemd[1]: Starting BIRD Internet Routing Daemon... May 27 22:51:38 gw07 systemd[1]: Started BIRD Internet Routing Daemon. May 27 22:51:38 gw07 bird[169094]: Started May 27 22:51:38 gw07 bird[169094]: Info (Proto: d_dummy0): 94.130.243.235/32 allowed due to dummy0(path ) May 27 22:51:38 gw07 bird[169094]: Info (Proto: d_dummy0): 2a01:4f8:140:4093::ff2:7/128 allowed due to dummy0 (path ) May 27 22:51:38 gw07 bird[169094]: Info (Proto: d_dummy0): 94.130.243.235/32 allowed ospf export dummy0 (path ) May 27 22:51:38 gw07 bird[169094]: Info (Proto: d_dummy0): 94.130.243.235/32 allowed ospf export dummy0 (path ) May 27 22:51:38 gw07 bird[169094]: Info (Proto: d_dummy0): 2a01:4f8:140:4093::ff2:7/128 allowed ospf export dummy0 (path ) May 27 22:51:38 gw07 bird[169094]: Info (Proto: d_dummy0): 2a01:4f8:140:4093::ff2:7/128 allowed ospf export dummy0 (path ) May 27 22:51:38 gw07 bird[169094]: [dn42] ROA check failed for fdc3:67ce:cc7e:9001::/64 ASN 0 May 27 22:51:40 gw07 systemd-coredump[169098]: [🡕] Process 169094 (bird) of user 993 dumped core. Module /nix/store/c2iqza2f6jx25ll6cjmjyz23lcm0mmm7-bird-3.1.1/bin/bird without build-id. Module libz.so.1 without build-id. Module libssh.so.4 without build-id. Stack trace of thread 169096: #0 0x0000000000000000 n/a (n/a + 0x0) ELF object binary architecture: AMD x86-64 May 27 22:51:40 gw07 systemd[1]: bird.service: Main process exited, code=dumped, status=11/SEGV May 27 22:51:40 gw07 systemd[1]: bird.service: Failed with result 'core-dump'. May 27 22:51:40 gw07 systemd[1]: bird.service: Consumed 156ms CPU time, 9.5M memory peak, 140.3K incoming IP traffic, 3.9K outgoing IP traffic. May 27 22:52:04 gw07 systemd[1]: Stopped BIRD Internet Routing Daemon. May 27 22:52:04 gw07 systemd[1]: bird.service: Consumed 156ms CPU time, 9.5M memory peak, 140.3K incoming IP traffic, 4K outgoing IP traffic. That's from 3.1.1. With 3.0.3 it's the same. Isn't happening with 3.0.2 for me. So seems like a regression. Haven't yet figured out how i could more useful log output. But that's probably also not strictly really necessary as i've seen that 3.1.2 (and 3.0.4) are probably about to be tagged. And with a build from https://gitlab.nic.cz/labs/bird/-/commit/a99792a74a6d3a06aead20616b1989c0a05... it seems to be resolved again. Just wanted to mention it in case this can boost confidence in the release just a tad so that we get it shortly. :) Thanks everyone for all the work! Tom Herbers
Hello Tom, On Wed, May 28, 2025 at 10:41:15AM +0200, Tom Herbers via Bird-users wrote:
just wanted to report shortly that i'm hitting some sort of regression with 3.1.1 as well as 3.0.3.
Thanks for your report! We have, as you are reporting below, already fixed it, and thank you for checking that it's resolved.
That's from 3.1.1. With 3.0.3 it's the same. Isn't happening with 3.0.2 for me. So seems like a regression.
This is probably that unfunny half-regression revealed by fixing the BGP route refresh code. When route refresh was broken, the bug was hidden, and manifested because route refresh suddenly became available. We failed to catch the regression by autotests.
Haven't yet figured out how i could more useful log output.
With crashes, the most useful output is actually the coredump or at least a backtrace to study. Logs typically don't tell much.
But that's probably also not strictly really necessary as i've seen that 3.1.2 (and 3.0.4) are probably about to be tagged.
And with a build from https://gitlab.nic.cz/labs/bird/-/commit/a99792a74a6d3a06aead20616b1989c0a05... it seems to be resolved again.
Just done that. Thank you for your patience! Maria -- Maria Matejka (she/her) | BIRD Team Leader | CZ.NIC, z.s.p.o.
Thanks for the reply, explanation and release! Am 28.05.25 um 12:17 schrieb Maria Matejka via Bird-users:
Hello Tom,
On Wed, May 28, 2025 at 10:41:15AM +0200, Tom Herbers via Bird-users wrote:
just wanted to report shortly that i’m hitting some sort of regression with 3.1.1 as well as 3.0.3.
Thanks for your report! We have, as you are reporting below, already fixed it, and thank you for checking that it’s resolved.
That’s from 3.1.1. With 3.0.3 it’s the same. Isn’t happening with 3.0.2 for me. So seems like a regression.
This is probably that unfunny half-regression revealed by fixing the BGP route refresh code. When route refresh was broken, the bug was hidden, and manifested because route refresh suddenly became available. We failed to catch the regression by autotests.
Haven’t yet figured out how i could more useful log output.
With crashes, the most useful output is actually the coredump or at least a backtrace to study. Logs typically don’t tell much.
But that’s probably also not strictly really necessary as i’ve seen that 3.1.2 (and 3.0.4) are probably about to be tagged.
And with a build from https://gitlab.nic.cz/labs/bird/-/commit/a99792a74a6d3a06aead20616b1989c0a05... it seems to be resolved again.
Just done that.
Thank you for your patience! Maria
– Maria Matejka (she/her) | BIRD Team Leader | CZ.NIC, z.s.p.o.
participants (5)
-
Douglas Fischer -
Jana Babovakova -
Marek Zarychta -
Maria Matejka -
Tom Herbers