sys/man/8/6in4

   1 .TH 6IN4 8
   2 .SH NAME
   3 6in4 - configure and run automatic or manual 6to4 tunnel of IPv6 through IPv4
   4 .SH SYNOPSIS
   5 .B ip/6in4
   6 [
   7 .B -ag
   8 ] [
   9 .B -x
  10 .I netmtpt
  11 ] [
  12 .B -o
  13 .I outnetmtpt
  14 ] [
  15 .IB local6[ / mask]
  16 [
  17 .I remote4
  18 [
  19 .I remote6
  20 ] ] ]
  21 .SH DESCRIPTION
  22 .I 6in4
  23 sets up and maintains a tunnel of IPv6 traffic through an IPv4 connection.
  24 .PP
  25 .I Local6
  26 and
  27 .I mask
  28 define the IPv6 address and subnet of the near end of the tunnel
  29 .RI ( mask
  30 defaults to
  31 .L /128
  32 for a single-host
  33 tunnel).
  34 If
  35 .I local6
  36 is missing or
  37 .LR - ,
  38 it defaults to
  39 .IP
  40 .BI 2002: aabb : ccdd ::1/48
  41 .PP
  42 where
  43 .IR aa ,
  44 .IR bb ,
  45 .I cc
  46 and
  47 .I dd
  48 are the hexadecimal equivalents of the bytes
  49 .IB a . b . c .\c
  50 .I d
  51 in this host's primary IPv4 address.
  52 .PP
  53 .I Remote4
  54 is the IPv4 address of the far end of the tunnel
  55 (must be given explicitly for a configured tunnel, or
  56 defaults to the anycast address 192.88.99.1 for
  57 .IR 6to4 ).
  58 .PP
  59 .I Remote6
  60 is the IPv6 address of the far end of the tunnel
  61 (used as the point-to-point destination for routing, and
  62 defaults to a link-local address constructed from
  63 .IR remote4 ).
  64 .PP
  65 .I 6in4
  66 forks a pair of background processes to copy packets to and from
  67 the tunnel.
  68 .PP
  69 Options are:
  70 .TF -x
  71 .PD 0
  72 .TP
  73 .B -a
  74 permit any remote IPv4 address as the far end of a tunnel.
  75 This is likely to be useful for the server side of a tunnel.
  76 .TP
  77 .B -g
  78 use the tunnel as the default route for global IPv6 addresses
  79 .TP
  80 .B -x
  81 use the network mounted at
  82 .I netmtpt
  83 instead of
  84 .LR /net
  85 for binding the tunnel interface and sending/receiving IPv4
  86 packets.
  87 .TP
  88 .B -o
  89 use
  90 .I outnetmtpt
  91 for the IPv4 packets but bind the IPv6 interface on
  92 .LR /net
  93 or
  94 .I netmtpt
  95 when specified by a previous
  96 .B -x
  97 option.
  98 .PD
  99 .SH EXAMPLES
 100 If your primary IPv4 address is public,
 101 you can start a
 102 .I 6to4
 103 tunnel simply with
 104 .IP
 105 .EX
 106 ip/6in4 -g
 107 .EE
 108 .PP
 109 Similarly, you can start a server for
 110 .I 6to4
 111 tunnels with
 112 .IP
 113 .EX
 114 ip/6in4 -ag
 115 .EE
 116 .PP
 117 If you use a tunnel broker at address
 118 .LR 5.6.7.8 ,
 119 configured to give you a
 120 .L /64
 121 subnet with address
 122 .LR 2001:1122:3344:5566:: ,
 123 you can start the tunnel with
 124 .IP
 125 .EX
 126 ip/6in4 -g 2001:1122:3344:5566::/64 5.6.7.8
 127 .EE
 128 .SH FILES
 129 .TF /net/ipmux
 130 .PD 0
 131 .TP
 132 .B /net/ipmux
 133 access to IPv6-in-IPv4 packets
 134 .TP
 135 .B /net/ipifc
 136 packet interface to IPv6 network
 137 .SH SEE ALSO
 138 .IR bridge (3),
 139 .I ipmux
 140 in
 141 .IR ip (3),
 142 .I linklocal
 143 in
 144 .IR ipconfig (8)
 145 .br
 146 .B /lib/rfc/rfc3056
 147 .br
 148 .B /lib/rfc/rfc3068
 149 .SH BUGS
 150 Needs a kernel with an
 151 .I ipmux
 152 driver.
 153 .PP
 154 The tunnel client filters addresses fairly conservatively in both directions.
 155 However it's not watertight,
 156 and may be flakey in other ways so don't put too much trust in it.