mirror of
https://github.com/openbsd/src.git
synced 2025-01-10 06:47:55 -08:00
Use the IPv6 documentation prefix 2001:db8::/32 from RFC 3849 instead
of the deprecated 3ffe::/16 6bone test address space. Deprecated or public IPv6 allocations should not be used for documentation; we have the same approach for IPv4 by using RFC 1918 private addresses. ok jmc@ todd@
This commit is contained in:
parent
bac4a82de0
commit
9632271deb
@ -1,7 +1,7 @@
|
||||
Configuring FAITH IPv6-to-IPv4 TCP relay
|
||||
|
||||
Kazu Yamamoto and Jun-ichiro itojun Hagino
|
||||
$OpenBSD: README,v 1.12 2008/06/04 18:11:35 miod Exp $
|
||||
$OpenBSD: README,v 1.13 2008/07/19 10:35:31 reyk Exp $
|
||||
$KAME: README,v 1.9 2002/05/09 14:10:06 itojun Exp $
|
||||
|
||||
|
||||
@ -28,12 +28,12 @@ invoked per each TCP services (TCP port number).
|
||||
clients IPv6 node "src" |
|
||||
|
||||
You will have to allocate an IPv6 address prefix to map IPv4 addresses into.
|
||||
The following description uses 3ffe:0501:ffff:0000:: as example.
|
||||
The following description uses 2001:db8:ffff:0000:: as example.
|
||||
Please use a prefix which belongs to your site.
|
||||
FAITH will make it possible to make a IPv6 TCP connection From IPv6 node
|
||||
"src", toward IPv4 node "dest", by specifying FAITH-mapped address
|
||||
3ffe:0501:ffff:0000::123.4.5.6
|
||||
(which is, 3ffe:0501:ffff:0000:0000:0000:7b04:0506).
|
||||
2001:db8:ffff:0000::123.4.5.6
|
||||
(which is, 2001:db8:ffff:0000:0000:0000:7b04:0506).
|
||||
The address mapping can be performed by hand:-), by special nameserver on
|
||||
the network, or by special resolver on the source node.
|
||||
|
||||
@ -42,7 +42,7 @@ Setup
|
||||
=====
|
||||
|
||||
The following example assumes:
|
||||
- You have assigned 3ffe:0501:ffff:0000:: as FAITH address prefix.
|
||||
- You have assigned 2001:db8:ffff:0000:: as FAITH address prefix.
|
||||
- You are willing to provide IPv6-to IPv4 TCP relay for telnet.
|
||||
|
||||
<<On the translating router on which faithd runs>>
|
||||
@ -58,8 +58,8 @@ The following example assumes:
|
||||
(3) Route packets toward FAITH prefix into "faith0" interface.
|
||||
|
||||
# ifconfig faith0 up
|
||||
# route add -inet6 3ffe:0501:ffff:0000:: -prefixlen 64 ::1
|
||||
# route change -inet6 3ffe:0501:ffff:0000:: -prefixlen 64 -ifp faith0
|
||||
# route add -inet6 2001:db8:ffff:0000:: -prefixlen 64 ::1
|
||||
# route change -inet6 2001:db8:ffff:0000:: -prefixlen 64 -ifp faith0
|
||||
|
||||
(4) Execute "faithd" by root as follows:
|
||||
|
||||
@ -97,7 +97,7 @@ There are two ways to translate IPv4 address to IPv6 address:
|
||||
(5.b) Add an entry into /etc/hosts so that you can resolve hostname into
|
||||
faked IPv6 address. For example, add the following line for www.netbsd.org:
|
||||
|
||||
3ffe:0501:ffff:0000::140.160.140.252 www.netbsd.org
|
||||
2001:db8:ffff:0000::140.160.140.252 www.netbsd.org
|
||||
|
||||
<<On the translating router on which faithd runs.>>
|
||||
|
||||
@ -127,13 +127,13 @@ Advanced configuration
|
||||
If you would like to restrict IPv4 destination for translation, you may
|
||||
want to do the following:
|
||||
|
||||
# route add -inet6 3ffe:0501:ffff:0000::123.0.0.0 -prefixlen 104 ::1
|
||||
# route change -inet6 3ffe:0501:ffff:0000::123.0.0.0 -prefixlen 104 \
|
||||
# route add -inet6 2001:db8:ffff:0000::123.0.0.0 -prefixlen 104 ::1
|
||||
# route change -inet6 2001:db8:ffff:0000::123.0.0.0 -prefixlen 104 \
|
||||
-ifp faith0
|
||||
|
||||
By this way, you can restrict IPv4 destination to 123.0.0.0/8.
|
||||
You may also want to reject packets toward 3ffe:0501:ffff:0000::/64 which
|
||||
is not in 3ffe:0501:ffff:0000::123.0.0.0/104. This will be left as excerside
|
||||
You may also want to reject packets toward 2001:db8:ffff:0000::/64 which
|
||||
is not in 2001:db8:ffff:0000::123.0.0.0/104. This will be left as excerside
|
||||
for the reader.
|
||||
|
||||
By doing this, you will be able to provide your IPv4 web server to outside
|
||||
|
@ -1,4 +1,4 @@
|
||||
.\" $OpenBSD: faithd.8,v 1.33 2008/05/17 23:31:52 sobrado Exp $
|
||||
.\" $OpenBSD: faithd.8,v 1.34 2008/07/19 10:35:31 reyk Exp $
|
||||
.\" $KAME: faithd.8,v 1.36 2002/05/09 13:59:16 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: May 17 2008 $
|
||||
.Dd $Mdocdate: July 19 2008 $
|
||||
.Dt FAITHD 8
|
||||
.Os
|
||||
.Sh NAME
|
||||
@ -63,13 +63,13 @@ connection is determined by the last 4 octets of the original
|
||||
.Tn IPv6
|
||||
destination.
|
||||
For example, if
|
||||
.Li 3ffe:0501:4819:ffff::
|
||||
.Li 2001:db8:4819:ffff::
|
||||
is reserved for
|
||||
.Nm faithd ,
|
||||
and the
|
||||
.Tn TCPv6
|
||||
destination address is
|
||||
.Li 3ffe:0501:4819:ffff::0a01:0101 ,
|
||||
.Li 2001:db8:4819:ffff::0a01:0101 ,
|
||||
the traffic is relayed to IPv4 destination
|
||||
.Li 10.1.1.1 .
|
||||
.Pp
|
||||
@ -258,8 +258,8 @@ interface has to be configured properly:
|
||||
# sysctl net.inet6.ip6.forwarding=1
|
||||
# sysctl net.inet6.ip6.keepfaith=1
|
||||
# ifconfig faith0 up
|
||||
# route add -inet6 3ffe:501:4819:ffff:: -prefixlen 96 ::1
|
||||
# route change -inet6 3ffe:501:4819:ffff:: -prefixlen 96 -ifp faith0
|
||||
# route add -inet6 2001:db8:4819:ffff:: -prefixlen 96 ::1
|
||||
# route change -inet6 2001:db8:4819:ffff:: -prefixlen 96 -ifp faith0
|
||||
.Ed
|
||||
.\".Ss Daemon mode samples
|
||||
.Pp
|
||||
@ -279,14 +279,14 @@ The following illustrates a simple
|
||||
.Pa faithd.conf
|
||||
setting.
|
||||
.Bd -literal -offset indent
|
||||
# Permit anyone from 3ffe:501:ffff::/48 to use the translator,
|
||||
# Permit anyone from 2001:db8:ffff::/48 to use the translator,
|
||||
# to connect to the following IPv4 destinations:
|
||||
# - any location except 10.0.0.0/8 and 127.0.0.0/8.
|
||||
# Permit no other connections.
|
||||
#
|
||||
3ffe:501:ffff::/48 deny 10.0.0.0/8
|
||||
3ffe:501:ffff::/48 deny 127.0.0.0/8
|
||||
3ffe:501:ffff::/48 permit 0.0.0.0/0
|
||||
2001:db8:ffff::/48 deny 10.0.0.0/8
|
||||
2001:db8:ffff::/48 deny 127.0.0.0/8
|
||||
2001:db8:ffff::/48 permit 0.0.0.0/0
|
||||
.Ed
|
||||
.Sh SEE ALSO
|
||||
.Xr faith 4 ,
|
||||
|
@ -25,9 +25,9 @@ changecom(,)dnl
|
||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" $OpenBSD: ppp.8.m4,v 1.40 2008/05/21 20:10:54 jmc Exp $
|
||||
.\" $OpenBSD: ppp.8.m4,v 1.41 2008/07/19 10:35:31 reyk Exp $
|
||||
.\"
|
||||
.Dd $Mdocdate: May 21 2008 $
|
||||
.Dd $Mdocdate: July 19 2008 $
|
||||
.Dt PPP 8
|
||||
.Os
|
||||
.Sh NAME
|
||||
@ -5481,8 +5481,8 @@ for
|
||||
.Ar gw .
|
||||
.Pp
|
||||
For example, a returned value of
|
||||
.Dq 3ffe:505:abcd::/48 ::
|
||||
would result in a routing table entry to the 3ffe:505:abcd::/48 network via
|
||||
.Dq 2001:db8:abcd::/48 ::
|
||||
would result in a routing table entry to the 2001:db8:abcd::/48 network via
|
||||
.Dv HISADDR6
|
||||
and a returned value of
|
||||
.Dq :: ::
|
||||
|
@ -1,4 +1,4 @@
|
||||
# $OpenBSD: rtadvd.conf,v 1.5 2003/06/25 03:46:15 itojun Exp $
|
||||
# $OpenBSD: rtadvd.conf,v 1.6 2008/07/19 10:35:31 reyk Exp $
|
||||
# $KAME: rtadvd.conf,v 1.12 2001/01/21 14:56:38 itojun Exp $
|
||||
#
|
||||
# Note: All of the following parameters have default values defined
|
||||
@ -18,4 +18,4 @@
|
||||
# this part by hand, and then invoke rtadvd with the -s option.
|
||||
|
||||
#ef0:\
|
||||
# :addr="3ffe:501:ffff:1000::":prefixlen#64:
|
||||
# :addr="2001:db8:ffff:1000::":prefixlen#64:
|
||||
|
@ -1,4 +1,4 @@
|
||||
.\" $OpenBSD: rtadvd.conf.5,v 1.22 2007/05/31 19:20:29 jmc Exp $
|
||||
.\" $OpenBSD: rtadvd.conf.5,v 1.23 2008/07/19 10:35:31 reyk Exp $
|
||||
.\" $KAME: rtadvd.conf.5,v 1.46 2003/06/17 08:26:35 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: May 31 2007 $
|
||||
.Dd $Mdocdate: July 19 2008 $
|
||||
.Dt RTADVD.CONF 5
|
||||
.Os
|
||||
.Sh NAME
|
||||
@ -271,7 +271,7 @@ option to
|
||||
.Xr rtadvd 8 .
|
||||
.Bd -literal -offset
|
||||
ef0:\\
|
||||
:addr="3ffe:501:ffff:1000::":prefixlen#64:
|
||||
:addr="2001:db8:ffff:1000::":prefixlen#64:
|
||||
.Ed
|
||||
.Pp
|
||||
The following example presents the default values in an explicit manner.
|
||||
@ -282,7 +282,7 @@ default:\\
|
||||
:chlim#64:raflags#0:rltime#1800:rtime#0:retrans#0:\\
|
||||
:pinfoflags="la":vltime#2592000:pltime#604800:mtu#0:
|
||||
ef0:\\
|
||||
:addr="3ffe:501:ffff:1000::":prefixlen#64:tc=default:
|
||||
:addr="2001:db8:ffff:1000::":prefixlen#64:tc=default:
|
||||
.Ed
|
||||
.Sh SEE ALSO
|
||||
.Xr termcap 5 ,
|
||||
|
Loading…
Reference in New Issue
Block a user