From baa6a68cbe47b257c771e9b7f7254750df46bd3f Mon Sep 17 00:00:00 2001
From: Alan Somers <asomers@FreeBSD.org>
Date: Sun, 24 Jul 2022 09:06:39 -0600
Subject: ip6(4): document IP_ORIGDSTADDR

The option was originally added in r313524, but with incomplete
documentation.

Reviewed by:	karels, gbe (manpages)
Differential Revision: https://reviews.freebsd.org/D35890

(cherry picked from commit a043594c211fd36228f4d84273885da50bb7f59c)
---
 share/man/man4/ip6.4 | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/share/man/man4/ip6.4 b/share/man/man4/ip6.4
index 9c94b3def444..9dd9007866a2 100644
--- a/share/man/man4/ip6.4
+++ b/share/man/man4/ip6.4
@@ -30,7 +30,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd July 30, 2021
+.Dd July 24, 2022
 .Dt IP6 4
 .Os
 .Sh NAME
@@ -156,9 +156,6 @@ datagrams sent on this socket.
 .\" .It Dv IPV6_RECVDSTADDR Fa "int *"
 .\" Get or set the status of whether datagrams are received with
 .\" destination addresses.
-.\" .It Dv IPV6_ORIGDSTADDR Fa "int *"
-.\" Get or set the status of whether datagrams are received with
-.\" destination addresses and destination ports.
 .\" .It Dv IPV6_RETOPTS
 .\" Get or set IPv6 options.
 .It Dv IPV6_MULTICAST_IF Fa "u_int *"
@@ -227,6 +224,14 @@ Note that setting to this value requires superuser privileges.
 Drop membership from the associated multicast group.
 Memberships are automatically dropped when the socket is closed or when
 the process exits.
+.It Dv IPV6_ORIGDSTADDR Fa "int *"
+Get or set whether a datagram's original destination address and port are
+returned as ancillary data along with the payload in subsequent
+.Xr recvmsg 2
+calls.
+The information is stored in the the ancillary data as a
+.Tn sockaddr_in6
+structure.
 .It Dv IPV6_PORTRANGE Fa "int *"
 Get or set the allocation policy of ephemeral ports for when the kernel
 automatically binds a local address to this socket.
@@ -420,8 +425,9 @@ The
 .Dv IPV6_HOPLIMIT ,
 .Dv IPV6_HOPOPTS ,
 .Dv IPV6_DSTOPTS ,
+.Dv IPV6_RTHDR ,
 and
-.Dv IPV6_RTHDR
+.Dv IPV6_ORIGDSTADDR
 options will return ancillary data along with payload contents in subsequent
 .Xr recvmsg 2
 calls with
@@ -432,7 +438,7 @@ and
 .Va cmsg_type
 set to respective option name value (e.g.,
 .Dv IPV6_HOPTLIMIT ) .
-These options may also be used directly as ancillary
+Some of these options may also be used directly as ancillary
 .Va cmsg_type
 values in
 .Xr sendmsg 2
-- 
cgit v1.2.3