From 4548338480299e356f94d310c1df27837558ba8d Mon Sep 17 00:00:00 2001
From: jmc <jmc@openbsd.org>
Date: Tue, 25 Apr 2017 13:52:08 +0000
Subject: [PATCH] some ip6 setup notes; help/ok bluhm

---
 share/man/man4/inet6.4 | 39 +++++++++++++++++++++++++++++++++++----
 1 file changed, 35 insertions(+), 4 deletions(-)

diff --git a/share/man/man4/inet6.4 b/share/man/man4/inet6.4
index 190dd79c151..7f1ea37fd93 100644
--- a/share/man/man4/inet6.4
+++ b/share/man/man4/inet6.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: inet6.4,v 1.41 2017/04/15 18:45:15 jmc Exp $
+.\"	$OpenBSD: inet6.4,v 1.42 2017/04/25 13:52:08 jmc Exp $
 .\"	$KAME: inet6.4,v 1.19 2000/11/24 10:13:18 itojun Exp $
 .\"
 .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
@@ -28,7 +28,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: April 15 2017 $
+.Dd $Mdocdate: April 25 2017 $
 .Dt INET6 4
 .Os
 .Sh NAME
@@ -145,13 +145,44 @@ sockets, kernel memory access via
 .Xr kvm 3 ,
 and some other occasions.
 HOWEVER, users should never use the embedded form.
+.Sh IPv6 SETUP
+Generally speaking,
+IPv6 connectivity is achieved in a fashion similar to that for IPv4.
+For native IPv6 setup,
+routers attach to the network either manually or using
+.Cm autoconf
+to connect to an ISP;
+hosts receive an address prefix from a router advertisement daemon such as
+.Xr rtadvd 8
+and use
+.Cm autoconf
+for stateless address configuration (SLAAC).
+For setups which tunnel IPv6 over IPv4,
+see
+.Xr gif 4 .
+.Pp
+The
+.Sx INET6
+and
+.Sx TUNNEL
+sections of
+.Xr ifconfig 8
+contain information relevant to IPv6 setups;
+settings can be made permanent using
+.Xr hostname.if 5
+files.
+Routers need to set the
+.Va net.inet6.ip6.forwarding
+.Xr sysctl 3 .
 .Sh SEE ALSO
 .Xr socket 2 ,
-.Xr sysctl 3 ,
 .Xr icmp6 4 ,
 .Xr ip6 4 ,
 .Xr tcp 4 ,
-.Xr udp 4
+.Xr udp 4 ,
+.Xr hostname.if 5 ,
+.Xr ifconfig 8 ,
+.Xr rtadvd 8
 .Sh STANDARDS
 .Rs
 .%A Tatsuya Jinmei
-- 
2.20.1