ifnet(9): Remove mention of defunct ifaddr_byindex(9).

Fixes:		964b8f8b99
MFC after:	3 days
Sponsored by:	Klara, Inc.
Reviewed by:	markj
Differential Revision:	https://reviews.freebsd.org/D46174

(cherry picked from commit 9f080f17a6)

ObsoleteFiles.inc

@@ -51,6 +51,9 @@
 #   xargs -n1 | sort | uniq -d;
 # done
 
+# 20240801: retire ifaddr_byindex
+OLD_FILES+=usr/share/man/man9/ifaddr_byindex.9.gz
+
 # 20240509: Remove remnants of portsnap(8)
 OLD_DIRS+=var/db/portsnap
 

share/man/man9/Makefile

@@ -1334,7 +1334,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 \

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"