netdev - ip-link manpage improvement

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>] [day] [month] [year] [list]

Message-ID: <20230526082618.3b0f731d@arc.aei.uni-hannover.de>
Date: Fri, 26 May 2023 08:26:18 +0200
From: Gerrit Kühn <gerrit.kuehn@....mpg.de>
To: netdev@...r.kernel.org
Subject: ip-link manpage improvement

Note: Please cc: me for any answers as I am not subscribed to this mailing
list.

Dear all,

I came across an issue with the ip link command that in the end boiled
down to an incomplete manpage entry:

---
ip link set { DEVICE | group GROUP }
---

This is missing one option (the "dev" part) compared to the help page (ip
link help):

---
ip link set { DEVICE | dev DEVICE | group DEVGROUP }
---

I surely lost a few hairs the other day because my vpn features a tap
interface named "dev" (for the "development" network), and to my surprise
"ip link set dev up" complained about device "up" not being found as the
"dev" part got eaten away by the parser due to the extra syntax I didn't
know about. ;)
It would be great if this could be fixed in the manpage to avoid confusion.

cu
  Gerrit