git: 9f080f17a6a7 - main - ifnet(9): Remove mention of defunct ifaddr_byindex(9).

From: Dag-Erling Smørgrav <des_at_FreeBSD.org>
Date: Mon, 29 Jul 2024 14:02:56 UTC
The branch main has been updated by des:

URL: https://cgit.FreeBSD.org/src/commit/?id=9f080f17a6a740ce9c1fa45862fb689263908c90

commit 9f080f17a6a740ce9c1fa45862fb689263908c90
Author:     Dag-Erling Smørgrav <des@FreeBSD.org>
AuthorDate: 2024-07-29 14:02:33 +0000
Commit:     Dag-Erling Smørgrav <des@FreeBSD.org>
CommitDate: 2024-07-29 14:02:33 +0000

    ifnet(9): Remove mention of defunct ifaddr_byindex(9).
    
    Fixes:          964b8f8b993d
    MFC after:      3 days
    Sponsored by:   Klara, Inc.
    Reviewed by:    markj
    Differential Revision:  https://reviews.freebsd.org/D46174
---
 ObsoleteFiles.inc       |  3 +++
 share/man/man9/Makefile |  1 -
 share/man/man9/ifnet.9  | 12 +-----------
 3 files changed, 4 insertions(+), 12 deletions(-)

diff --git a/ObsoleteFiles.inc b/ObsoleteFiles.inc
index 088dd23ebb4d..1a347f5e8dbd 100644
--- a/ObsoleteFiles.inc
+++ b/ObsoleteFiles.inc
@@ -51,6 +51,9 @@
 #   xargs -n1 | sort | uniq -d;
 # done
 
+# 20240729: retire ifaddr_byindex
+OLD_FILES+=usr/share/man/man9/ifaddr_byindex.9.gz
+
 # 20240726: deprecate contigfree(9)
 OLD_FILES+=usr/share/man/man9/contigfree.9.gz
 
diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile
index 0b315d64ed35..7b50921b955f 100644
--- a/share/man/man9/Makefile
+++ b/share/man/man9/Makefile
@@ -1335,7 +1335,6 @@ MLINKS+=ifnet.9 if_addmulti.9 \
 	ifnet.9 ifa_ifwithnet.9 \
 	ifnet.9 ifa_ref.9 \
 	ifnet.9 ifaddr.9 \
-	ifnet.9 ifaddr_byindex.9 \
 	ifnet.9 ifaof_ifpforaddr.9 \
 	ifnet.9 ifioctl.9 \
 	ifnet.9 ifpromisc.9 \
diff --git a/share/man/man9/ifnet.9 b/share/man/man9/ifnet.9
index b835c51c546f..41cbfd8dad42 100644
--- a/share/man/man9/ifnet.9
+++ b/share/man/man9/ifnet.9
@@ -75,8 +75,6 @@
 .\"
 .Ss "Interface Address Functions"
 .Ft "struct ifaddr *"
-.Fn ifaddr_byindex "u_short idx"
-.Ft "struct ifaddr *"
 .Fn ifa_ifwithaddr "struct sockaddr *addr"
 .Ft "struct ifaddr *"
 .Fn ifa_ifwithdstaddr "struct sockaddr *addr" "int fib"
@@ -196,8 +194,6 @@ address
 .Xr link_addr 3 )
 describing the link layer implemented by the interface (if any)
 is accessed by the
-.Fn ifaddr_byindex
-function or
 .Va if_addr
 structure.
 (Some trivial interfaces do not provide any link layer addresses;
@@ -1183,9 +1179,7 @@ structure to be the first element in that list.
 (A pointer to
 this address structure is saved in the
 .Vt ifnet
-structure and is accessed by the
-.Fn ifaddr_byindex
-function.)
+structure.)
 The
 .Fa ifp
 must have been allocated by
@@ -1502,10 +1496,6 @@ precisely
 .Fa addr
 will be returned.
 .Pp
-.Fn ifaddr_byindex
-returns the link-level address of the interface with the given index
-.Fa idx .
-.Pp
 All of these functions return a null pointer if no such address can be
 found.
 .Ss "Interface Multicast Address Functions"