netdev - Is the manpage wrong for "ip address delete"?

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <20240712005252.5408c0a9@gnosticus.teln.shikadi.net>
Date: Fri, 12 Jul 2024 00:52:52 +1000
From: Adam Nielsen <a.nielsen@...kadi.net>
To: netdev@...r.kernel.org
Subject: Is the manpage wrong for "ip address delete"?

Hi all,

I'm trying to remove an IP address from an interface, without having to
specify it, but the behaviour doesn't seem to match the manpage.

In the manpage for ip-address it states:

    ip address delete - delete protocol address
       Arguments: coincide with the arguments of ip addr add.  The
       device name is a required  argument. The rest are optional.  If no
       arguments are given, the first address is deleted.

I can't work out how to trigger the "if no arguments are given" part:

  $ ip address delete dev eth0
  RTNETLINK answers: Operation not supported

  $ ip address delete "" dev eth0
  Error: any valid prefix is expected rather than "".

  $ ip address dev eth0 delete
  Command "dev" is unknown, try "ip address help".

In the end I worked out that "ip address flush dev eth0" did what I
wanted, but I'm just wondering whether the manpage needs to be updated
to reflect the current behaviour?

Cheers,
Adam.

(Not subscribed, please CC)