Discussion:
Bug#862216: release-notes: [Stretch] improve text about iproute2 and net-tools
(too old to reply)
Andreas Henriksson
2017-05-09 21:30:01 UTC
Permalink
Package: release-notes
Severity: normal

Hello,

I recently ran across the stretch release notes draft and particularly
"5.3.9. iproute2 will replace net-tools".
See https://www.debian.org/releases/stretch/amd64/release-notes/ch-information.en.html#iproute2

This might be nitpicking but I find the text slightly misleading, so
I thought I'd share some thoughts.

"[...], while iproute2 has been upgraded to important."

This happened almost a decade ago (in 2008) and has been part of new
debian installations since Debian 5.0 Lenny.

The net-tools package is still available as well so for those still
wanting to use it still can, they just need to explicitly install it.

I'm not sure I should write these texts but here's an attempt at providing
an alternative description.

------------------8<-------8<------8<------8<-------------------------------

5.3.9 Users are adviced to use iproute2 instead of net-tools

The net-tools package is no longer part of new installations by default, since it's priority has been lowered from important to optional. Users are instead advised to use the modern iproute2 toolset (which has been part of new installs for several releases already and continues to be).
If you still prefer to continue using the net-tools programs you can simply install it via 'apt install net-tools'.

Here is a summary of the net-tools commands, together with their iproute2 equivalent:

[...]

------------------8<-------8<------8<------8<-------------------------------


Please note that the 'iw' command (as suggested for iwconfig
replacement) is not from the iproute2 toolset, but rather from it's own
package 'iw'!
Similar for the ifrename command, which I wonder if it shouldn't be
considered a legacy command instead of a replacement for anything.
Modern interface naming tools more high level than 'ip link' would
likely be systemd-networkd these days.


(Original suggestion seems to have been in http://bugs.debian.org/851229 )

Hope this helps. Feel free to close this without action if you feel
the current text serves the purpose of release notes well enough
already. Also feel free to reach out to ***@packages.debian.org
for any advice related to the package and its usage.


Regards,
Andreas Henriksson


-- System Information:
Debian Release: 9.0
APT prefers unstable-debug
APT policy: (500, 'unstable-debug'), (500, 'testing-debug'), (500, 'unstable'), (1, 'experimental-debug'), (1, 'experimental')
Architecture: amd64
(x86_64)

Kernel: Linux 4.9.0-3-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
Baptiste Jammet
2017-05-18 12:40:02 UTC
Permalink
Control: tags -1 patch

Hello,
Post by Andreas Henriksson
I recently ran across the stretch release notes draft and particularly
"5.3.9. iproute2 will replace net-tools".
[...]
Post by Andreas Henriksson
I'm not sure I should write these texts but here's an attempt at
providing an alternative description.
[...]
I used your words in this new patch.
Post by Andreas Henriksson
Please note that the 'iw' command (as suggested for iwconfig
replacement) is not from the iproute2 toolset, but rather from it's own
package 'iw'!
Removed.
Post by Andreas Henriksson
Similar for the ifrename command, which I wonder if it shouldn't be
considered a legacy command instead of a replacement for anything.
Modern interface naming tools more high level than 'ip link' would
likely be systemd-networkd these days.
Removed too.
Post by Andreas Henriksson
Hope this helps.
Yes, thanks.
Post by Andreas Henriksson
for any advice related to the package and its usage.
Keeping in Cc if someone wants to comment. I intend to commit in few
days if noone disagree.

Baptiste
Andreas Henriksson
2017-05-18 14:50:02 UTC
Permalink
Hello Baptiste,
Post by Baptiste Jammet
Control: tags -1 patch
[...]

Just a minor nitpit, which is unrelated but that I noticed when looking
at your patch.

There seems to be a missing space in "netstat-r" which you might also
want to fix while at it ( => "netstat -r").

Regards,
Andreas Henriksson
Debian Bug Tracking System
2017-05-18 12:40:02 UTC
Permalink
Post by Baptiste Jammet
tags -1 patch
Bug #862216 [release-notes] release-notes: [Stretch] improve text about iproute2 and net-tools
Added tag(s) patch.
--
862216: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=862216
Debian Bug Tracking System
Contact ***@bugs.debian.org with problems
Debian Bug Tracking System
2017-05-27 13:20:01 UTC
Permalink
Your message dated Sat, 27 May 2017 15:15:57 +0200
with message-id <***@mailoo.org>
and subject line Re: Bug#862216: release-notes: [Stretch] improve text about iproute2 and net-tools
has caused the Debian Bug report #862216,
regarding release-notes: [Stretch] improve text about iproute2 and net-tools
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact ***@bugs.debian.org
immediately.)
--
862216: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=862216
Debian Bug Tracking System
Contact ***@bugs.debian.org with problems
Loading...