16to4relay(1M) System Administration Commands 6to4relay(1M)
2
6 6to4relay - administer configuration for 6to4 relay router communica‐
7 tion
8
10 /usr/sbin/6to4relay
11 /usr/sbin/6to4relay [-e] [-a addr]
14 /usr/sbin/6to4relay [-d]
17 /usr/sbin/6to4relay [-h]
20
23 The 6to4relay command is used to configure 6to4 relay router communica‐
24 tion. Relay router communication support is enabled by setting the
25 value of a variable that stores an IPv4 address within the tun module.
26 This variable is global to all tunnels and defines the policy for com‐
27 munication with relay routers. By default, the address is set to
28 INADDR_ANY (0.0.0.0), and the kernel interprets the value to indicate
29 that support for relay router communication is disabled. Otherwise,
30 support is enabled, and the specified address is used as the IPv4 des‐
31 tination address when packets destined for native IPv6 (non-6to4) hosts
32 are sent through the 6to4 tunnel interface. The 6to4relay command uses
33 a project private ioctl to set the variable.
34 6to4relay used without any options outputs the current, in-kernel, con‐
37 figuration status. Use the -a option to send packets to a specific
38 relay router's unicast address instead of the default anycast address.
39 The address specified with the -a option does not specify the policy
40 for receiving traffic from relay routers. The source relay router on a
41 received packet is non-deterministic, since a different relay router
42 may be chosen for each sending native IPv6 end-point.
43 Configuration changes made by using the 6to4relay are not persistent
46 across reboot. The changes will persist in the kernel only until you
47 take the tunnel down
48
50 The 6to4relay command supports the following options:
51 -a addr Use the specified address, addr.
53 -e Enable support for relay router. Use -a addr if it is speci‐
56 fied. Otherwise, use the default anycast address,
57 192.88.99.1.
58 -d Disable support for the relay router.
61 -h Help
64
67 The following operands are supported:
68 addr A specific relay router's unicast address. addr must be speci‐
70 fied as a dotted decimal representation of an IPv4 address.
71 Otherwise, an error will occur, and the command will fail.
72
75 Example 1 Printing the In-Kernel Configuration Status
76 Use /usr/sbin/6to4relay without any options to print the in-kernel con‐
79 figuration status.
80 example# /usr/sbin/6to4relay
83 If 6to4 relay router communication is disabled, the administrator will
88 see the following message:
89 6to4relay: 6to4 Relay Router communication support is disabled.
92 If 6to4 router communication is enabled, the user will see this mes‐
97 sage:
98 6to4relay: 6to4 Relay Router communication support is enabled.
100 IPv4 destination address of Relay Router = 192.88.99.1
101
105 The following exit values are returned:
106 0 Successful completion.
108 >0 An error occurred.
111
114 /usr/sbin/6to4relay The default installation root
115
118 See attributes(5) for descriptions of the following attributes:
119 ┌─────────────────────────────┬─────────────────────────────┐
124 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
125 ├─────────────────────────────┼─────────────────────────────┤
126 │Availability │SUNWcsu │
127 ├─────────────────────────────┼─────────────────────────────┤
128 │Interface Stability │Evolving │
129 └─────────────────────────────┴─────────────────────────────┘
130
132 ifconfig(1M), attributes(5)
133 Huitema, C. RFC 3068, An Anycast Prefix for 6to4 Relay Routers. Network
136 Working Group. June, 2001.
137 Carpenter, B. and Moore, K. RFC 3056, Connection of IPv6 Domains via
140 IPv4 Clouds. Network Working Group. February, 2001.
141
143 The 6to4relay reports the following messages:
144 6to4relay: input (0.0.0.0) is not a valid IPv4 unicast address
146 Example:
149 The following example provides an incorrect unicast address.
152 example# 6to4relay -e -a 0.0.0.0
154 Description:
156 The address specified with the -a option must be a valid unicast
159 address.
160 6to4relay: option requires an argument -a
163 usage:
164 6to4relay
165 6to4relay -e [-a <addr>]
166 6to4relay -d
167 6to4relay -h
168 Example:
171 The following example does not include an argument for the -a
174 option.
175 example# 6to4relay -e -a
177 Description:
179 The -a option requires an argument.
182 usage:
185 6to4relay
186 6to4relay -e [-a <addr>]
187 6to4relay -d
188 6to4relay -h
189 Example:
192 The following example specifies options that are not permitted.
195 example# 6to4relay -e -d
197 Description:
199 The options specified are not permitted. A usage message is output
202 to the screen.
203 usage:
206 6to4relay
207 6to4relay -e [-a <addr>]
208 6to4relay -d
209 6to4relay -h
210 Example:
213 The following example specifies the -a option without specifying
216 the -e option.
217 example# 6to4relay -a 1.2.3.4
219 Description:
221 The -e option is required in conjunction with the -a option. A
224 usage message is output to the screen.
225 6to4relay: ioctl (I_STR) : Invalid argument
228 Example:
231 The following example specifies an invalid address.
234 example# 6to4relay -e -a 239.255.255.255
236 Description:
238 The address specified with the -a option must not be a class d
241 addr.
242SunOS 5.11 19 Nov 2002 6to4relay(1M)