git: 9f080f17a6a7 - main - ifnet(9): Remove mention of defunct ifaddr_byindex(9).
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
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"