Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.debian.bugs.dist > #1249886

Bug#1107739: iproute2: ip-route(8) man page: incorrect "ip route delete" documentation

From Vincent Lefevre <vincent@vinc17.net>
Newsgroups linux.debian.bugs.dist, linux.debian.kernel
Subject Bug#1107739: iproute2: ip-route(8) man page: incorrect "ip route delete" documentation
Date 2025-06-13 12:30 +0200
Message-ID <KX9Pz-agbL-1@gated-at.bofh.it> (permalink)
Organization linux.* mail to news gateway

Cross-posted to 2 groups.

Show all headers | View raw


Package: iproute2
Version: 6.15.0-1
Severity: normal

The documentation of "ip route delete" in the ip-route(8) man page is
incorrect. The man page says:

  ip route delete
    delete route
    ip  route  del  has the same arguments as ip route add, but their
    semantics are a bit different.

    Key values (to, tos, preference and table) select  the  route  to
    delete. If optional attributes are present, ip verifies that they
    coincide with the attributes of the route to delete.  If no route
    with the given key and attributes was found, ip route del fails.

But the behavior is unclear when several routes match the argument.
Above, the singular is used, so I assume that a single route will
be deleted (this is what I can observe). However, in such a case,
it should say "a route", not "the route", because the route is not
completely identified. Or better, say which route will be deleted.

Note that the vpnc-script script of vpnc-scripts for VPNC and
OpenConnect assumes that "ip route del ..." will delete all the
matching routes:

  https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1107738

-- System Information:
Debian Release: 13.0
  APT prefers unstable-debug
  APT policy: (500, 'unstable-debug'), (500, 'stable-updates'), (500, 'stable-security'), (500, 'stable-debug'), (500, 'proposed-updates-debug'), (500, 'unstable'), (500, 'testing'), (500, 'stable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 6.12.32-amd64 (SMP w/16 CPU threads; PREEMPT)
Locale: LANG=C.UTF-8, LC_CTYPE=C.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages iproute2 depends on:
ii  debconf [debconf-2.0]  1.5.91
ii  libbpf1                1:1.5.0-3
ii  libc6                  2.41-8
ii  libcap2                1:2.75-8
ii  libcap2-bin            1:2.75-8
ii  libdb5.3t64            5.3.28+dfsg2-9
ii  libelf1t64             0.192-4
ii  libmnl0                1.0.5-3
ii  libselinux1            3.8.1-1
ii  libtirpc3t64           1.3.6+ds-1
ii  libxtables12           1.8.11-2

iproute2 recommends no packages.

Versions of packages iproute2 suggests:
ii  python3  3.13.4-1

-- debconf information:
  iproute2/setcaps: false

-- 
Vincent Lefèvre <vincent@vinc17.net> - Web: <https://www.vinc17.net/>
100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
Work: CR INRIA - computer arithmetic / Pascaline project (LIP, ENS-Lyon)

Back to linux.debian.bugs.dist | Previous | Next — Next in thread | Find similar | Unroll thread


Thread

Bug#1107739: iproute2: ip-route(8) man page: incorrect "ip route delete" documentation Vincent Lefevre <vincent@vinc17.net> - 2025-06-13 12:30 +0200
  Bug#1107739: iproute2: ip-route(8) man page: incorrect "ip route delete" documentation Luca Boccassi <bluca@debian.org> - 2025-06-13 12:50 +0200
    Bug#1107739: iproute2: ip-route(8) man page: incorrect "ip route delete" documentation Vincent Lefevre <vincent@vinc17.net> - 2025-06-13 14:30 +0200
  Bug#1107739: iproute2: ip-route(8) man page: incorrect "ip route delete" documentation Bjørn Mork <bjorn@mork.no> - 2025-06-13 18:40 +0200
    Bug#1107739: iproute2: ip-route(8) man page: incorrect "ip route delete" documentation Vincent Lefevre <vincent@vinc17.net> - 2025-06-13 20:00 +0200
      Bug#1107739: iproute2: ip-route(8) man page: incorrect "ip route delete" documentation Bjørn Mork <bjorn@mork.no> - 2025-06-13 20:10 +0200

csiph-web