summaryrefslogtreecommitdiff
path: root/net/6to4/files/6to4.8
diff options
context:
space:
mode:
Diffstat (limited to 'net/6to4/files/6to4.8')
-rw-r--r--net/6to4/files/6to4.8211
1 files changed, 0 insertions, 211 deletions
diff --git a/net/6to4/files/6to4.8 b/net/6to4/files/6to4.8
deleted file mode 100644
index c3586ef92a2..00000000000
--- a/net/6to4/files/6to4.8
+++ /dev/null
@@ -1,211 +0,0 @@
-.\" $NetBSD: 6to4.8,v 1.8 2002/09/25 00:03:39 wiz Exp $
-.Dd July 3, 2002
-.Dt 6TO4 8
-.Os
-.Sh NAME
-.Nm 6to4
-.Nd setup automatic 6to4 IPv6 tunnelling
-.Sh SYNOPSIS
-.Nm
-.Op Fl vn
-.Ar command
-.Sh DESCRIPTION
-The
-.Nm
-script can be used to setup IPv6 on your home machine and
-network for exploring IPv6 without any registrations. 6to4 is a
-mechanism by which your IPv6 address(es) are derived from an assigned
-IPv4 address, and which involves automatic tunnelling to one or more
-remove 6to4 hubs, which will then forward your v6 packets on the 6bone
-etc. Replies are routed back to you over IPv4 via (possibly) other
-6to4 capable remote gateways. As such, IPv6-in-IPv4-encapsulated
-packets are accepted from all v4-hosts.
-.Pp
-From your (single) IPv4 address, you get a whole IPv6 /48 network,
-which allows you to split your network in 2^16 subnets, with 2^64
-hosts each. You need to setup routing for your internal network
-properly, help is provided for setting up the border router here.
-.Pp
-This script takes the burden to calculate your IPv6 address from
-existing IPv4 address and runs the commands to setup (and tear down)
-automatic 6to4 IPv6 tunnelling. In a seperate step, router
-advertisement for the inside network can be started and stopped.
-.Pp
-Possible options are:
-.Bl -tag -width xxx
-.It Fl n
-Do not. Only print the commands that would be run, but do not execute
-them.
-.It Fl v
-Verbose operation. Print the commands that are about to be run, before
-running them. Displays some additional information.
-.It Fl h
-Show usage.
-.El
-.Pp
-Possible commands are:
-.Bl -tag -width rtadvd-start
-.It Sy start
-Configure 6to4 IPv6. The
-.Xr stf 4
-interface is configured, and a default route to a remote 6to4
-gateway is established. In addition, the internal
-network interface is assigned an address.
-.It Sy stop
-Stops 6to4 IPv6. All addresses are removed from the
-.Xr stf 4
-device, and the default route is removed.
-.It Sy rtadvd-start
-Starts router advertizement and IPv6 packet forwarding,
-turning the machine into a IPv6 router.
-.Xr rtadvd 8
-is invoked with a custom config file created under
-.Pa /var/run .
-Clients just need to be told to accept router advertizements, i.e.
-the
-.Sq net.inet6.ip6.accept_rtadv
-sysctl needs to be set to
-.Sq 1 .
-You can arrange that by setting
-.Dq ip6mode=autohost
-in
-.Pa /etc/rc.conf .
-.It Sy rtadvd-stop
-Stops router advertizement and IPv6 packet forwarding.
-.Xr rtadvd 8
-is stopped, and the
-.Xr rtadvd.conf 5
-config file is removed from
-.Pa /var/run .
-.El
-.Sh REQUIREMENTS
-Besides IPv4 connectivity, you need support for IPv6 and the
-.Xr stf 4
-device in your kernel. While the GENERIC
-.Nx
-1.5 kernel does support IPv6, it does not contain support for the
-.Xr stf 4
-device.
-.Pp
-Make sure you have the following options in your kernel config file:
-.Bd -literal -offset
-options INET # IP + ICMP + TCP + UDP
-options INET6 # IPV6
-pseudo-device stf 1 # 6to4 IPv6 over IPv4 encapsulation
-.Ed
-.Pp
-In systems that run past-1.5
-.Nx Ns -current ,
-you will have to explicitly create an
-.Xr stf 4
-device after compiling it in the kernel. You do this by running
-the following command before calling the
-.Nm
-script:
-.Bd -literal -offset
-ifconfig stf0 create
-.Ed
-.Pp
-No special values are needed in
-.Pa /etc/rc.conf
-to run this script, but see comment on setting up IPv6-clients
-.Sq behind
-your 6to4 router for the
-.Sy rtadvd-start
-command!
-.Sh CONFIGURATION
-The
-.Nm
-script reads its configuration from a config file named
-.Pa 6to4.conf .
-The
-.Pa 6to4.conf
-file is in
-.Xr perl 1
-syntax, and contains several
-variables that can be tuned to adjust your setup. Default values
-should work for use on a modem dialup.
-.Bl -tag -width rtadvd-stop
-.It Sy out_if
-The outbound interface that has a valid IPv4 address
-assigned, that can be used to derive the IPv6
-addresses from. Usually
-.Dq ppp0
-for a modem setup, or your ethernet interface if you have
-IPv4 connectivity via LAN. This
-can't be empty, and is assigned the IPv6 address
-2002:x:x:v6_net:hostbits6, see below.
-.It Sy in_if
-The inside interface. If non-empty, this interface is
-assigned the IPv6 address
-2002:x:x:v6_innernet:hostbits6, see below.
-This is only useful on machines that
-have more than one network interfaces, e.g. with a modem and a
-local ethernet.
-.It Sy v6_net
-The subnet address you want to use on the address of
-your outbound interface. Defaults to
-.Dq 1 .
-.It Sy v6_innernet
-The subnet address you want to use on the address of
-your inbound interface. Defaults to
-.Dq 2 .
-.It Sy hostbits6
-The lower 64 bits of both the inbound and outbound interface's
-addresses.
-.It Sy peer
-Name of the remote 6to4 server that'll take our
-IPv6-in-IPv4 encapsulated packets and route them on
-via IPv6. A special value of
-.Dq 6to4-anycast
-can be used for the anycast service defined in RFC 3068.
-Other possible values are given in the example config file.
-.It Sy remoteadr4, remoteadr6
-If the
-.Sy peer
-variable is set to the relay router's name, DNS lookups for A and AAAA
-records will be made to
-determine its IPv4 and IPv6 address. To avoid these lookups, the variables
-.Sy remoteadr4
-and
-.Sy remoteadr6
-can be set to strings containing the numerical IPv4 and IPv6 numbers
-directly.
-.El
-.Sh EXAMPLES
-The
-.Nm
-script can be run automatically by
-.Xr pppd 8
-when a connection is made. For this, put the following into
-.Pa /etc/ppp/ip-up :
-.Bd -literal -offset
-( /usr/pkg/sbin/6to4 stop
- /usr/pkg/sbin/6to4 start ) &
-.Ed
-.Pp
-To shut down properly, put this into
-.Pa /etc/ppp/ip-down :
-.Bd -literal -offset
-/usr/pkg/sbin/6to4 stop
-.Ed
-.Sh SEE ALSO
-.Xr stf 4 ,
-.Dq 6to4 IPv6 Explained
-at
-.Pa http://www.feyrer.de/NetBSD/6to4.html ,
-.Nx
-IPv6 Documentation at
-.Pa http://www.netbsd.org/Documentation/network/ipv6/ ,
-RFC 3068.
-.Sh HISTORY
-The
-.Nm
-utility and manpage were written by
-Hubert Feyrer <hubert@feyrer.de>.
-.Sh BUGS
-On systems running past-1.5
-.Nx Ns -current ,
-the
-.Dq ifconfig stf0 create
-should be run automatically.