Skip to contentSkip to conversation

man: remove libnetlink man page

PATCH Applied Stephen Hemminger 3 participants 4 messages Apr 27 – Sep 2

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 man: remove libnetlink man page

The iproute2 libnetlink is not a public and stable API. Having a man page encourages users to think it is available.

---
 man/Makefile          |   2 +-
 man/man3/Makefile     |  18 ----
 man/man3/libnetlink.3 | 200 ------------------------------------------
 3 files changed, 1 insertion(+), 219 deletions(-)
 delete mode 100644 man/man3/Makefile
 delete mode 100644 man/man3/libnetlink.3
man/Makefile +1 -1
index c0b0d416..91dd8f3d 100644
@@ -8,7 +8,7 @@ MAN_CHECK=LC_ALL=en_US.UTF-8 MANROFFSEQ='' MANWIDTH=100 man --warnings \
 # Hide man output, count and print errors.
 MAN_REDIRECT=2>&1 >/dev/null | tee /dev/fd/2 | wc -l
 
-SUBDIRS = man3 man7 man8
+SUBDIRS = man7 man8
 
 all clean install check:
 	@for subdir in $(SUBDIRS); do $(MAKE) -C $$subdir $@ || exit $$?; done
man/man3/Makefile deleted +0 -18
deleted file mode 100644
index 1732be26..00000000
@@ -1,18 +0,0 @@
-# SPDX-License-Identifier: GPL-2.0
-MAN3PAGES = $(wildcard *.3)
-
-all:
-
-distclean: clean
-
-clean:
-
-install:
-	$(INSTALLDIR) $(DESTDIR)$(MANDIR)/man3
-	$(INSTALLMAN) $(MAN3PAGES) $(DESTDIR)$(MANDIR)/man3
-
-check:
-	@for page in $(MAN3PAGES); do test 0 -eq $$($(MAN_CHECK) $$page \
-		$(MAN_REDIRECT)) || { echo "Error in $$page"; exit 1; }; done
-
-.PHONY: install clean distclean check
man/man3/libnetlink.3 deleted +0 -200

200 lines not on this page · raw message

Signature · 1 line
2.53.0
#1 lore raw
This patch was applied to iproute2/iproute2-next.git (main) by David Ahern <[email protected]>:

Hello:

This patch was applied to iproute2/iproute2-next.git (main) by David Ahern <[email protected]>:

Quoted 11 lines · On Mon, 27 Apr 2026 10:28:27 -0700 you wrote:

The iproute2 libnetlink is not a public and stable API. Having a man page encourages users to think it is available.

---
 man/Makefile          |   2 +-
 man/man3/Makefile     |  18 ----
 man/man3/libnetlink.3 | 200 ------------------------------------------
 3 files changed, 1 insertion(+), 219 deletions(-)
 delete mode 100644 man/man3/Makefile
 delete mode 100644 man/man3/libnetlink.3

Here is the summary with links:
- [iproute2-next] man: remove libnetlink man page

    https://git.kernel.org/pub/scm/network/iproute2/iproute2-next.git/commit/?id=fa2309a9e91e

You are awesome, thank you!

Signature · 2 lines
Deet-doot-dot, I am a bot.
https://korg.docs.kernel.org/patchwork/pwbot.html
#2 lore raw
In reply to Stephen Hemminger
Quoted 6 lines · Stephen Hemminger

The iproute2 libnetlink is not a public and stable API. Having a man page encourages users to think it is available.
---

man/Makefile          |   2 +-
man/man3/Makefile     |  18 ----
man/man3/libnetlink.3 | 200 ------------------------------------------

If it is not public, why are the header files and static library still getting copied on make install? (What's the "secret" user of this library, if any?)

#3 lore raw
Quoted 9 lines · Jan Engelhardt
Quoted 6 lines · Stephen Hemminger

The iproute2 libnetlink is not a public and stable API. Having a man page encourages users to think it is available.
---

man/Makefile          |   2 +-
man/man3/Makefile     |  18 ----
man/man3/libnetlink.3 | 200 ------------------------------------------
Quoted 3 lines

If it is not public, why are the header files and static library still getting copied on make install? (What's the "secret" user of this library, if any?)

Found an answer faster than I had anticipated.
It was not iproute2 that installed it, but openSUSE's own .spec file. And it seems mipv6d was that user, but a long long time ago (2014), when libnetlink was used.