xref: /illumos-gate/usr/src/uts/common/inet/ip6.h (revision 7014882c6a3672fd0e5d60200af8643ae53c5928)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
23  * Use is subject to license terms.
24  */
25 
26 #ifndef	_INET_IP6_H
27 #define	_INET_IP6_H
28 
29 #ifdef	__cplusplus
30 extern "C" {
31 #endif
32 
33 #include <sys/isa_defs.h>
34 
35 #ifdef	_KERNEL
36 /* icmp6_t is used in the prototype of icmp_inbound_error_fanout_v6() */
37 #include <netinet/icmp6.h>
38 #endif	/* _KERNEL */
39 
40 /* version number for IPv6 - hard to get this one wrong! */
41 #define	IPV6_VERSION		6
42 
43 #define	IPV6_HDR_LEN		40
44 
45 #define	IPV6_ADDR_LEN		16
46 
47 /*
48  * IPv6 address scopes.  The values of these enums also match the scope
49  * field of multicast addresses.
50  */
51 typedef enum {
52 	IP6_SCOPE_INTFLOCAL = 1,	/* Multicast addresses only */
53 	IP6_SCOPE_LINKLOCAL,
54 	IP6_SCOPE_SUBNETLOCAL,		/* Multicast addresses only */
55 	IP6_SCOPE_ADMINLOCAL,		/* Multicast addresses only */
56 	IP6_SCOPE_SITELOCAL,
57 	IP6_SCOPE_GLOBAL
58 } in6addr_scope_t;
59 
60 /* From RFC 3542 - setting for IPV6_USE_MIN_MTU socket option */
61 #define	IPV6_USE_MIN_MTU_MULTICAST	-1	/* Default */
62 #define	IPV6_USE_MIN_MTU_NEVER		0
63 #define	IPV6_USE_MIN_MTU_ALWAYS		1
64 
65 #ifdef	_KERNEL
66 
67 /* Extract the scope from a multicast address */
68 #ifdef _BIG_ENDIAN
69 #define	IN6_ADDR_MC_SCOPE(addr) \
70 	(((addr)->s6_addr32[0] & 0x000f0000) >> 16)
71 #else
72 #define	IN6_ADDR_MC_SCOPE(addr) \
73 	(((addr)->s6_addr32[0] & 0x00000f00) >> 8)
74 #endif
75 
76 /* Default IPv4 TTL for IPv6-in-IPv4 encapsulated packets */
77 #define	IPV6_DEFAULT_HOPS	60	/* XXX What should it be? */
78 
79 /* Max IPv6 TTL */
80 #define	IPV6_MAX_HOPS	255
81 
82 /* Minimum IPv6 MTU from rfc2460 */
83 #define	IPV6_MIN_MTU		1280
84 
85 /* EUI-64 based token length */
86 #define	IPV6_TOKEN_LEN		64
87 
88 /* Length of an advertised IPv6 prefix */
89 #define	IPV6_PREFIX_LEN		64
90 
91 /* Default and maximum tunnel encapsulation limits.  See RFC 2473. */
92 #define	IPV6_DEFAULT_ENCAPLIMIT	4
93 #define	IPV6_MAX_ENCAPLIMIT	255
94 
95 /*
96  * Minimum and maximum extension header lengths for IPv6.  The 8-bit
97  * length field of each extension header (see rfc2460) specifies the
98  * number of 8 octet units of data in the header not including the
99  * first 8 octets.  A value of 0 would indicate 8 bytes (0 * 8 + 8),
100  * and 255 would indicate 2048 bytes (255 * 8 + 8).
101  */
102 #define	MIN_EHDR_LEN		8
103 #define	MAX_EHDR_LEN		2048
104 
105 #ifdef _BIG_ENDIAN
106 #define	IPV6_DEFAULT_VERS_AND_FLOW	0x60000000
107 #define	IPV6_VERS_AND_FLOW_MASK		0xF0000000
108 #define	V6_MCAST			0xFF000000
109 #define	V6_LINKLOCAL			0xFE800000
110 
111 #define	IPV6_FLOW_TCLASS(x)		(((x) & IPV6_FLOWINFO_TCLASS) >> 20)
112 #define	IPV6_TCLASS_FLOW(f, c)		(((f) & ~IPV6_FLOWINFO_TCLASS) |\
113 					((c) << 20))
114 #else
115 #define	IPV6_DEFAULT_VERS_AND_FLOW	0x00000060
116 #define	IPV6_VERS_AND_FLOW_MASK		0x000000F0
117 #define	V6_MCAST			0x000000FF
118 #define	V6_LINKLOCAL			0x000080FE
119 
120 #define	IPV6_FLOW_TCLASS(x)		((((x) & 0xf000U) >> 12) |\
121 					(((x) & 0xf) << 4))
122 #define	IPV6_TCLASS_FLOW(f, c)		(((f) & ~IPV6_FLOWINFO_TCLASS) |\
123 					((((c) & 0xf) << 12) |\
124 					(((c) & 0xf0) >> 4)))
125 #endif
126 
127 /*
128  * UTILITY MACROS FOR ADDRESSES.
129  */
130 
131 /*
132  * Convert an IPv4 address mask to an IPv6 mask.   Pad with 1-bits.
133  */
134 #define	V4MASK_TO_V6(v4, v6)	((v6).s6_addr32[0] = 0xffffffffUL,	\
135 				(v6).s6_addr32[1] = 0xffffffffUL,	\
136 				(v6).s6_addr32[2] = 0xffffffffUL,	\
137 				(v6).s6_addr32[3] = (v4))
138 
139 /*
140  * Convert aligned IPv4-mapped IPv6 address into an IPv4 address.
141  * Note: We use "v6" here in definition of macro instead of "(v6)"
142  * Not possible to use "(v6)" here since macro is used with struct
143  * field names as arguments.
144  */
145 #define	V4_PART_OF_V6(v6)	v6.s6_addr32[3]
146 
147 #ifdef _BIG_ENDIAN
148 #define	V6_OR_V4_INADDR_ANY(a)	((a).s6_addr32[3] == 0 &&		\
149 				((a).s6_addr32[2] == 0xffffU ||	\
150 				(a).s6_addr32[2] == 0) &&		\
151 				(a).s6_addr32[1] == 0 &&		\
152 				(a).s6_addr32[0] == 0)
153 
154 #else
155 #define	V6_OR_V4_INADDR_ANY(a)	((a).s6_addr32[3] == 0 && 		\
156 				((a).s6_addr32[2] == 0xffff0000U ||	\
157 				(a).s6_addr32[2] == 0) &&		\
158 				(a).s6_addr32[1] == 0 &&		\
159 				(a).s6_addr32[0] == 0)
160 #endif /* _BIG_ENDIAN */
161 
162 /* IPv4-mapped CLASSD addresses */
163 #ifdef _BIG_ENDIAN
164 #define	IN6_IS_ADDR_V4MAPPED_CLASSD(addr) \
165 	(((addr)->_S6_un._S6_u32[2] == 0x0000ffff) && \
166 	(CLASSD((addr)->_S6_un._S6_u32[3])) && \
167 	((addr)->_S6_un._S6_u32[1] == 0) && \
168 	((addr)->_S6_un._S6_u32[0] == 0))
169 #else  /* _BIG_ENDIAN */
170 #define	IN6_IS_ADDR_V4MAPPED_CLASSD(addr) \
171 	(((addr)->_S6_un._S6_u32[2] == 0xffff0000U) && \
172 	(CLASSD((addr)->_S6_un._S6_u32[3])) && \
173 	((addr)->_S6_un._S6_u32[1] == 0) && \
174 	((addr)->_S6_un._S6_u32[0] == 0))
175 #endif /* _BIG_ENDIAN */
176 
177 /* Clear an IPv6 addr */
178 #define	V6_SET_ZERO(a)		((a).s6_addr32[0] = 0,			\
179 				(a).s6_addr32[1] = 0,			\
180 				(a).s6_addr32[2] = 0,			\
181 				(a).s6_addr32[3] = 0)
182 
183 /* Mask comparison: is IPv6 addr a, and'ed with mask m, equal to addr b? */
184 #define	V6_MASK_EQ(a, m, b)						\
185 	((((a).s6_addr32[0] & (m).s6_addr32[0]) == (b).s6_addr32[0]) &&	\
186 	(((a).s6_addr32[1] & (m).s6_addr32[1]) == (b).s6_addr32[1]) &&	\
187 	(((a).s6_addr32[2] & (m).s6_addr32[2]) == (b).s6_addr32[2]) &&	\
188 	(((a).s6_addr32[3] & (m).s6_addr32[3]) == (b).s6_addr32[3]))
189 
190 #define	V6_MASK_EQ_2(a, m, b)						\
191 	((((a).s6_addr32[0] & (m).s6_addr32[0]) ==			\
192 	    ((b).s6_addr32[0]  & (m).s6_addr32[0])) &&			\
193 	(((a).s6_addr32[1] & (m).s6_addr32[1]) ==			\
194 	    ((b).s6_addr32[1]  & (m).s6_addr32[1])) &&			\
195 	(((a).s6_addr32[2] & (m).s6_addr32[2]) ==			\
196 	    ((b).s6_addr32[2]  & (m).s6_addr32[2])) &&			\
197 	(((a).s6_addr32[3] & (m).s6_addr32[3]) ==			\
198 	    ((b).s6_addr32[3]  & (m).s6_addr32[3])))
199 
200 /* Copy IPv6 address (s), logically and'ed with mask (m), into (d) */
201 #define	V6_MASK_COPY(s, m, d)						\
202 	((d).s6_addr32[0] = (s).s6_addr32[0] & (m).s6_addr32[0],	\
203 	(d).s6_addr32[1] = (s).s6_addr32[1] & (m).s6_addr32[1],		\
204 	(d).s6_addr32[2] = (s).s6_addr32[2] & (m).s6_addr32[2],		\
205 	(d).s6_addr32[3] = (s).s6_addr32[3] & (m).s6_addr32[3])
206 
207 #define	ILL_FRAG_HASH_V6(v6addr, i)					\
208 	((ntohl((v6addr).s6_addr32[3]) ^ (i ^ (i >> 8))) % 		\
209 						ILL_FRAG_HASH_TBL_COUNT)
210 
211 
212 /*
213  * GLOBAL EXTERNALS
214  */
215 extern const in6_addr_t	ipv6_all_ones;
216 extern const in6_addr_t	ipv6_all_zeros;
217 extern const in6_addr_t	ipv6_loopback;
218 extern const in6_addr_t	ipv6_all_hosts_mcast;
219 extern const in6_addr_t	ipv6_all_rtrs_mcast;
220 extern const in6_addr_t	ipv6_all_v2rtrs_mcast;
221 extern const in6_addr_t	ipv6_solicited_node_mcast;
222 extern const in6_addr_t	ipv6_unspecified_group;
223 
224 /*
225  * FUNCTION PROTOTYPES
226  */
227 
228 extern void	convert2ascii(char *buf, const in6_addr_t *addr);
229 extern char	*inet_ntop(int, const void *, char *, int);
230 extern int	inet_pton(int, char *, void *);
231 extern void	icmp_param_problem_nexthdr_v6(mblk_t *, boolean_t,
232     ip_recv_attr_t *);
233 extern void	icmp_pkt2big_v6(mblk_t *, uint32_t, boolean_t,
234     ip_recv_attr_t *);
235 extern void	icmp_time_exceeded_v6(mblk_t *, uint8_t, boolean_t,
236     ip_recv_attr_t *);
237 extern void	icmp_unreachable_v6(mblk_t *, uint8_t, boolean_t,
238     ip_recv_attr_t *);
239 extern mblk_t	*icmp_inbound_v6(mblk_t *, ip_recv_attr_t *);
240 extern void	icmp_inbound_error_fanout_v6(mblk_t *, icmp6_t *,
241     ip_recv_attr_t *);
242 extern void	icmp_update_out_mib_v6(ill_t *, icmp6_t *);
243 
244 extern boolean_t conn_wantpacket_v6(conn_t *, ip_recv_attr_t *, ip6_t *);
245 
246 extern in6addr_scope_t	ip_addr_scope_v6(const in6_addr_t *);
247 extern void	ip_build_hdrs_v6(uchar_t *, uint_t, const ip_pkt_t *, uint8_t,
248     uint32_t);
249 extern void	ip_fanout_udp_multi_v6(mblk_t *, ip6_t *, uint16_t, uint16_t,
250     ip_recv_attr_t *);
251 extern void	ip_fanout_send_icmp_v6(mblk_t *, uint_t, uint8_t,
252     ip_recv_attr_t *);
253 extern void	ip_fanout_proto_v6(mblk_t *, ip6_t *, ip_recv_attr_t *);
254 extern int	ip_find_hdr_v6(mblk_t *, ip6_t *, boolean_t, ip_pkt_t *,
255     uint8_t *);
256 extern in6_addr_t ip_get_dst_v6(ip6_t *, const mblk_t *, boolean_t *);
257 extern ip6_rthdr_t	*ip_find_rthdr_v6(ip6_t *, uint8_t *);
258 extern boolean_t	ip_hdr_length_nexthdr_v6(mblk_t *, ip6_t *,
259     uint16_t *, uint8_t **);
260 extern int	ip_hdr_length_v6(mblk_t *, ip6_t *);
261 extern uint32_t	ip_massage_options_v6(ip6_t *, ip6_rthdr_t *, netstack_t *);
262 extern void	ip_forward_xmit_v6(nce_t *, mblk_t *, ip6_t *, ip_recv_attr_t *,
263     uint32_t, uint32_t);
264 extern mblk_t	*ip_fraghdr_add_v6(mblk_t *, uint32_t, ip_xmit_attr_t *);
265 extern int	ip_fragment_v6(mblk_t *, nce_t *, iaflags_t, uint_t, uint32_t,
266     uint32_t, zoneid_t, zoneid_t, pfirepostfrag_t postfragfn,
267     uintptr_t *ixa_cookie);
268 extern int	ip_process_options_v6(mblk_t *, ip6_t *,
269     uint8_t *, uint_t, uint8_t, ip_recv_attr_t *);
270 extern void	ip_process_rthdr(mblk_t *, ip6_t *, ip6_rthdr_t *,
271     ip_recv_attr_t *);
272 extern int	ip_total_hdrs_len_v6(const ip_pkt_t *);
273 extern mblk_t	*ipsec_early_ah_v6(mblk_t *, ip_recv_attr_t *);
274 extern int	ipsec_ah_get_hdr_size_v6(mblk_t *, boolean_t);
275 extern void	ip_send_potential_redirect_v6(mblk_t *, ip6_t *, ire_t *,
276     ip_recv_attr_t *);
277 extern void	ip_rput_v6(queue_t *, mblk_t *);
278 extern mblk_t	*mld_input(mblk_t *, ip_recv_attr_t *);
279 extern void	mld_joingroup(ilm_t *);
280 extern void	mld_leavegroup(ilm_t *);
281 extern void	mld_timeout_handler(void *);
282 
283 extern void	pr_addr_dbg(char *, int, const void *);
284 extern void	*ip6_kstat_init(netstackid_t, ip6_stat_t *);
285 extern void	ip6_kstat_fini(netstackid_t, kstat_t *);
286 extern size_t	ip6_get_src_preferences(ip_xmit_attr_t *, uint32_t *);
287 extern int	ip6_set_src_preferences(ip_xmit_attr_t *, uint32_t);
288 
289 #endif	/* _KERNEL */
290 
291 #ifdef	__cplusplus
292 }
293 #endif
294 
295 #endif	/* _INET_IP6_H */
296