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.
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.
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]
22 * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
23 * Use is subject to license terms.
29 #include <netinet/in.h>
30 #include <sys/int_types.h>
31 #include <sys/queue.h>
32 #include <sys/hook_impl.h>
33 #include <sys/netstack.h>
39 #define NETINFO_VERSION 1
42 * Network hooks framework stack protocol name
44 #define NHF_INET "NHF_INET"
45 #define NHF_INET6 "NHF_INET6"
46 #define NHF_ARP "NHF_ARP"
49 * Event identification
51 #define NH_PHYSICAL_IN "PHYSICAL_IN"
52 #define NH_PHYSICAL_OUT "PHYSICAL_OUT"
53 #define NH_FORWARDING "FORWARDING"
54 #define NH_LOOPBACK_IN "LOOPBACK_IN"
55 #define NH_LOOPBACK_OUT "LOOPBACK_OUT"
56 #define NH_NIC_EVENTS "NIC_EVENTS"
57 #define NH_OBSERVE "OBSERVING"
60 * Network NIC hardware checksum capability
62 #define NET_HCK_NONE 0x00
63 #define NET_HCK_L3_FULL 0x01
64 #define NET_HCK_L3_PART 0x02
65 #define NET_HCK_L4_FULL 0x10
66 #define NET_HCK_L4_PART 0x20
68 #define NET_IS_HCK_L3_FULL(n, x) \
69 ((net_ispartialchecksum(n, x) & NET_HCK_L3_FULL) == NET_HCK_L3_FULL)
70 #define NET_IS_HCK_L3_PART(n, x) \
71 ((net_ispartialchecksum(n, x) & NET_HCK_L3_PART) == NET_HCK_L3_PART)
72 #define NET_IS_HCK_L4_FULL(n, x) \
73 ((net_ispartialchecksum(n, x) & NET_HCK_L4_FULL) == NET_HCK_L4_FULL)
74 #define NET_IS_HCK_L4_PART(n, x) \
75 ((net_ispartialchecksum(n, x) & NET_HCK_L4_PART) == NET_HCK_L4_PART)
76 #define NET_IS_HCK_L34_FULL(n, x) \
77 ((net_ispartialchecksum(n, x) & (NET_HCK_L3_FULL|NET_HCK_L4_FULL)) \
78 == (NET_HCK_L3_FULL | NET_HCK_L4_FULL))
80 typedef uintptr_t phy_if_t
;
81 typedef intptr_t lif_if_t
;
82 typedef uintptr_t net_ifdata_t
;
86 * Netinfo interface specification
88 * Netinfo provides an extensible and easy to use interface for
89 * accessing data and functionality already embedded within network
90 * code that exists within the kernel.
92 typedef enum net_ifaddr
{
100 typedef enum inject
{
107 * net_inject - public interface
109 typedef struct net_inject
{
113 struct sockaddr_storage ni_addr
;
114 phy_if_t ni_physical
;
117 typedef struct net_data
*net_handle_t
;
120 * net_protocol_t private interface
122 struct net_protocol_s
{
125 int (*netp_getifname
)(net_handle_t
, phy_if_t
, char *,
127 int (*netp_getmtu
)(net_handle_t
, phy_if_t
, lif_if_t
);
128 int (*netp_getpmtuenabled
)(net_handle_t
);
129 int (*netp_getlifaddr
)(net_handle_t
, phy_if_t
, lif_if_t
,
130 size_t, net_ifaddr_t
[], void *);
131 int (*neti_getlifzone
)(net_handle_t
, phy_if_t
, lif_if_t
,
133 int (*neti_getlifflags
)(net_handle_t
, phy_if_t
, lif_if_t
,
135 phy_if_t (*netp_phygetnext
)(net_handle_t
, phy_if_t
);
136 phy_if_t (*netp_phylookup
)(net_handle_t
, const char *);
137 lif_if_t (*netp_lifgetnext
)(net_handle_t
, phy_if_t
, lif_if_t
);
138 int (*netp_inject
)(net_handle_t
, inject_t
, net_inject_t
*);
139 phy_if_t (*netp_routeto
)(net_handle_t
, struct sockaddr
*,
141 int (*netp_ispartialchecksum
)(net_handle_t
, mblk_t
*);
142 int (*netp_isvalidchecksum
)(net_handle_t
, mblk_t
*);
144 typedef struct net_protocol_s net_protocol_t
;
148 * Private data structures
151 LIST_ENTRY(net_data
) netd_list
;
152 net_protocol_t netd_info
;
154 hook_family_int_t
*netd_hooks
;
155 struct neti_stack_s
*netd_stack
;
160 typedef struct injection_s
{
161 net_inject_t inj_data
;
167 * The ipif_id space is [0,MAX) but this interface wants to return [1,MAX] as
168 * a valid range of logical interface numbers so that it can return 0 to mean
169 * "end of list" with net_lifgetnext. Changing ipif_id's to use the [1,MAX]
170 * space is something to be considered for the future, if it is worthwhile.
172 #define MAP_IPIF_ID(x) ((x) + 1)
173 #define UNMAP_IPIF_ID(x) (((x) > 0) ? (x) - 1 : (x))
175 struct net_instance_s
{
178 void *(*nin_create
)(const netid_t
);
179 void (*nin_destroy
)(const netid_t
, void *);
180 void (*nin_shutdown
)(const netid_t
, void *);
182 typedef struct net_instance_s net_instance_t
;
184 struct net_instance_int_s
{
185 LIST_ENTRY(net_instance_int_s
) nini_next
;
188 struct net_instance_int_s
*nini_parent
;
189 net_instance_t
*nini_instance
;
190 hook_notify_t nini_notify
;
193 boolean_t nini_condemned
;
195 typedef struct net_instance_int_s net_instance_int_t
;
196 LIST_HEAD(nini_head_s
, net_instance_int_s
);
197 typedef struct nini_head_s nini_head_t
;
199 #define nini_version nini_instance->nin_version
200 #define nini_name nini_instance->nin_name
201 #define nini_create nini_instance->nin_create
202 #define nini_destroy nini_instance->nin_destroy
203 #define nini_shutdown nini_instance->nin_shutdown
206 * netinfo stack instances
208 struct neti_stack_s
{
210 LIST_ENTRY(neti_stack_s
) nts_next
;
213 netstackid_t nts_stackid
;
214 netstack_t
*nts_netstack
;
215 nini_head_t nts_instances
;
218 /* list of net_handle_t */
219 LIST_HEAD(netd_listhead
, net_data
) nts_netd_head
;
221 typedef struct neti_stack_s neti_stack_t
;
222 LIST_HEAD(neti_stack_head_s
, neti_stack_s
);
223 typedef struct neti_stack_head_s neti_stack_head_t
;
226 * Internal functions that need to be exported within the module.
228 extern void neti_init(void);
229 extern void neti_fini(void);
230 extern neti_stack_t
*net_getnetistackbyid(netid_t
);
231 extern netstackid_t
net_getnetstackidbynetid(netid_t
);
232 extern netid_t
net_getnetidbynetstackid(netstackid_t
);
233 extern netid_t
net_zoneidtonetid(zoneid_t
);
234 extern zoneid_t
net_getzoneidbynetid(netid_t
);
237 * Functions available for public use.
239 extern hook_event_token_t
net_event_register(net_handle_t
, hook_event_t
*);
240 extern int net_event_shutdown(net_handle_t
, hook_event_t
*);
241 extern int net_event_unregister(net_handle_t
, hook_event_t
*);
242 extern int net_event_notify_register(net_handle_t
, char *,
243 hook_notify_fn_t
, void *);
244 extern int net_event_notify_unregister(net_handle_t
, char *, hook_notify_fn_t
);
246 extern int net_family_register(net_handle_t
, hook_family_t
*);
247 extern int net_family_shutdown(net_handle_t
, hook_family_t
*);
248 extern int net_family_unregister(net_handle_t
, hook_family_t
*);
250 extern int net_hook_register(net_handle_t
, char *, hook_t
*);
251 extern int net_hook_unregister(net_handle_t
, char *, hook_t
*);
253 extern int net_inject(net_handle_t
, inject_t
, net_inject_t
*);
254 extern net_inject_t
*net_inject_alloc(const int);
255 extern void net_inject_free(net_inject_t
*);
257 extern net_instance_t
*net_instance_alloc(const int version
);
258 extern void net_instance_free(net_instance_t
*);
259 extern int net_instance_register(net_instance_t
*);
260 extern int net_instance_unregister(net_instance_t
*);
261 extern int net_instance_notify_register(netid_t
, hook_notify_fn_t
, void *);
262 extern int net_instance_notify_unregister(netid_t netid
, hook_notify_fn_t
);
264 extern kstat_t
*net_kstat_create(netid_t
, char *, int, char *, char *,
265 uchar_t
, ulong_t
, uchar_t
);
266 extern void net_kstat_delete(netid_t
, kstat_t
*);
268 extern net_handle_t
net_protocol_lookup(netid_t
, const char *);
269 extern net_handle_t
net_protocol_register(netid_t
, const net_protocol_t
*);
270 extern int net_protocol_release(net_handle_t
);
271 extern int net_protocol_unregister(net_handle_t
);
272 extern net_handle_t
net_protocol_walk(netid_t
, net_handle_t
);
273 extern int net_protocol_notify_register(net_handle_t
, hook_notify_fn_t
, void *);
274 extern int net_protocol_notify_unregister(net_handle_t
, hook_notify_fn_t
);
277 extern int net_getifname(net_handle_t
, phy_if_t
, char *, const size_t);
278 extern int net_getmtu(net_handle_t
, phy_if_t
, lif_if_t
);
279 extern int net_getpmtuenabled(net_handle_t
);
280 extern int net_getlifaddr(net_handle_t
, phy_if_t
, lif_if_t
,
281 int, net_ifaddr_t
[], void *);
282 extern zoneid_t
net_getlifzone(net_handle_t
, phy_if_t
, lif_if_t
, zoneid_t
*);
283 extern int net_getlifflags(net_handle_t
, phy_if_t
, lif_if_t
, uint64_t *);
284 extern phy_if_t
net_phygetnext(net_handle_t
, phy_if_t
);
285 extern phy_if_t
net_phylookup(net_handle_t
, const char *);
286 extern lif_if_t
net_lifgetnext(net_handle_t
, phy_if_t
, lif_if_t
);
287 extern phy_if_t
net_routeto(net_handle_t
, struct sockaddr
*,
289 extern int net_ispartialchecksum(net_handle_t
, mblk_t
*);
290 extern int net_isvalidchecksum(net_handle_t
, mblk_t
*);
296 #endif /* _SYS_NETI_H */