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 2008 Sun Microsystems, Inc. All rights reserved. 23 * Use is subject to license terms. 24 */ 25 26 #ifndef _SYS_NETI_H 27 #define _SYS_NETI_H 28 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> 34 35 #ifdef __cplusplus 36 extern "C" { 37 #endif 38 39 #define NETINFO_VERSION 1 40 41 /* 42 * Network hooks framework stack protocol name 43 */ 44 #define NHF_INET "NHF_INET" 45 #define NHF_INET6 "NHF_INET6" 46 #define NHF_ARP "NHF_ARP" 47 48 /* 49 * Event identification 50 */ 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 58 /* 59 * Network NIC hardware checksum capability 60 */ 61 #define NET_HCK_NONE 0x00 62 #define NET_HCK_L3_FULL 0x01 63 #define NET_HCK_L3_PART 0x02 64 #define NET_HCK_L4_FULL 0x10 65 #define NET_HCK_L4_PART 0x20 66 67 #define NET_IS_HCK_L3_FULL(n, x) \ 68 ((net_ispartialchecksum(n, x) & NET_HCK_L3_FULL) == NET_HCK_L3_FULL) 69 #define NET_IS_HCK_L3_PART(n, x) \ 70 ((net_ispartialchecksum(n, x) & NET_HCK_L3_PART) == NET_HCK_L3_PART) 71 #define NET_IS_HCK_L4_FULL(n, x) \ 72 ((net_ispartialchecksum(n, x) & NET_HCK_L4_FULL) == NET_HCK_L4_FULL) 73 #define NET_IS_HCK_L4_PART(n, x) \ 74 ((net_ispartialchecksum(n, x) & NET_HCK_L4_PART) == NET_HCK_L4_PART) 75 #define NET_IS_HCK_L34_FULL(n, x) \ 76 ((net_ispartialchecksum(n, x) & (NET_HCK_L3_FULL|NET_HCK_L4_FULL)) \ 77 == (NET_HCK_L3_FULL | NET_HCK_L4_FULL)) 78 79 typedef uintptr_t phy_if_t; 80 typedef intptr_t lif_if_t; 81 typedef uintptr_t net_ifdata_t; 82 typedef id_t netid_t; 83 84 /* 85 * Netinfo interface specification 86 * 87 * Netinfo provides an extensible and easy to use interface for 88 * accessing data and functionality already embedded within network 89 * code that exists within the kernel. 90 */ 91 typedef enum net_ifaddr { 92 NA_ADDRESS = 1, 93 NA_PEER, 94 NA_BROADCAST, 95 NA_NETMASK 96 } net_ifaddr_t; 97 98 99 typedef enum inject { 100 NI_QUEUE_IN = 1, 101 NI_QUEUE_OUT, 102 NI_DIRECT_OUT 103 } inject_t; 104 105 /* 106 * net_inject - public interface 107 */ 108 typedef struct net_inject { 109 int ni_version; 110 netid_t ni_netid; 111 mblk_t *ni_packet; 112 struct sockaddr_storage ni_addr; 113 phy_if_t ni_physical; 114 } net_inject_t; 115 116 typedef struct net_data *net_handle_t; 117 118 /* 119 * net_protocol_t private interface 120 */ 121 struct net_protocol_s { 122 int netp_version; 123 char *netp_name; 124 int (*netp_getifname)(net_handle_t, phy_if_t, char *, 125 const size_t); 126 int (*netp_getmtu)(net_handle_t, phy_if_t, lif_if_t); 127 int (*netp_getpmtuenabled)(net_handle_t); 128 int (*netp_getlifaddr)(net_handle_t, phy_if_t, lif_if_t, 129 size_t, net_ifaddr_t [], void *); 130 int (*neti_getlifzone)(net_handle_t, phy_if_t, lif_if_t, 131 zoneid_t *); 132 int (*neti_getlifflags)(net_handle_t, phy_if_t, lif_if_t, 133 uint64_t *); 134 phy_if_t (*netp_phygetnext)(net_handle_t, phy_if_t); 135 phy_if_t (*netp_phylookup)(net_handle_t, const char *); 136 lif_if_t (*netp_lifgetnext)(net_handle_t, phy_if_t, lif_if_t); 137 int (*netp_inject)(net_handle_t, inject_t, net_inject_t *); 138 phy_if_t (*netp_routeto)(net_handle_t, struct sockaddr *, 139 struct sockaddr *); 140 int (*netp_ispartialchecksum)(net_handle_t, mblk_t *); 141 int (*netp_isvalidchecksum)(net_handle_t, mblk_t *); 142 }; 143 typedef struct net_protocol_s net_protocol_t; 144 145 146 /* 147 * Private data structures 148 */ 149 struct net_data { 150 LIST_ENTRY(net_data) netd_list; 151 net_protocol_t netd_info; 152 int netd_refcnt; 153 hook_family_int_t *netd_hooks; 154 struct neti_stack_s *netd_stack; 155 int netd_condemned; 156 }; 157 158 159 typedef struct injection_s { 160 net_inject_t inj_data; 161 boolean_t inj_isv6; 162 void * inj_ptr; 163 } injection_t; 164 165 /* 166 * The ipif_id space is [0,MAX) but this interface wants to return [1,MAX] as 167 * a valid range of logical interface numbers so that it can return 0 to mean 168 * "end of list" with net_lifgetnext. Changing ipif_id's to use the [1,MAX] 169 * space is something to be considered for the future, if it is worthwhile. 170 */ 171 #define MAP_IPIF_ID(x) ((x) + 1) 172 #define UNMAP_IPIF_ID(x) (((x) > 0) ? (x) - 1 : (x)) 173 174 struct net_instance_s { 175 int nin_version; 176 char *nin_name; 177 void *(*nin_create)(const netid_t); 178 void (*nin_destroy)(const netid_t, void *); 179 void (*nin_shutdown)(const netid_t, void *); 180 }; 181 typedef struct net_instance_s net_instance_t; 182 183 struct net_instance_int_s { 184 LIST_ENTRY(net_instance_int_s) nini_next; 185 uint_t nini_ref; 186 void *nini_created; 187 struct net_instance_int_s *nini_parent; 188 net_instance_t *nini_instance; 189 hook_notify_t nini_notify; 190 uint32_t nini_flags; 191 kcondvar_t nini_cv; 192 boolean_t nini_condemned; 193 }; 194 typedef struct net_instance_int_s net_instance_int_t; 195 LIST_HEAD(nini_head_s, net_instance_int_s); 196 typedef struct nini_head_s nini_head_t; 197 198 #define nini_version nini_instance->nin_version 199 #define nini_name nini_instance->nin_name 200 #define nini_create nini_instance->nin_create 201 #define nini_destroy nini_instance->nin_destroy 202 #define nini_shutdown nini_instance->nin_shutdown 203 204 /* 205 * netinfo stack instances 206 */ 207 struct neti_stack_s { 208 kmutex_t nts_lock; 209 LIST_ENTRY(neti_stack_s) nts_next; 210 netid_t nts_id; 211 zoneid_t nts_zoneid; 212 netstackid_t nts_stackid; 213 netstack_t *nts_netstack; 214 nini_head_t nts_instances; 215 uint32_t nts_flags; 216 kcondvar_t nts_cv; 217 /* list of net_handle_t */ 218 LIST_HEAD(netd_listhead, net_data) nts_netd_head; 219 }; 220 typedef struct neti_stack_s neti_stack_t; 221 LIST_HEAD(neti_stack_head_s, neti_stack_s); 222 typedef struct neti_stack_head_s neti_stack_head_t; 223 224 /* 225 * Internal functions that need to be exported within the module. 226 */ 227 extern void neti_init(void); 228 extern void neti_fini(void); 229 extern neti_stack_t *net_getnetistackbyid(netid_t); 230 extern netstackid_t net_getnetstackidbynetid(netid_t); 231 extern netid_t net_getnetidbynetstackid(netstackid_t); 232 extern netid_t net_zoneidtonetid(zoneid_t); 233 extern zoneid_t net_getzoneidbynetid(netid_t); 234 235 /* 236 * Functions available for public use. 237 */ 238 extern hook_event_token_t net_event_register(net_handle_t, hook_event_t *); 239 extern int net_event_shutdown(net_handle_t, hook_event_t *); 240 extern int net_event_unregister(net_handle_t, hook_event_t *); 241 extern int net_event_notify_register(net_handle_t, char *, 242 hook_notify_fn_t, void *); 243 extern int net_event_notify_unregister(net_handle_t, char *, hook_notify_fn_t); 244 245 extern int net_family_register(net_handle_t, hook_family_t *); 246 extern int net_family_shutdown(net_handle_t, hook_family_t *); 247 extern int net_family_unregister(net_handle_t, hook_family_t *); 248 249 extern int net_hook_register(net_handle_t, char *, hook_t *); 250 extern int net_hook_unregister(net_handle_t, char *, hook_t *); 251 252 extern int net_inject(net_handle_t, inject_t, net_inject_t *); 253 extern net_inject_t *net_inject_alloc(const int); 254 extern void net_inject_free(net_inject_t *); 255 256 extern net_instance_t *net_instance_alloc(const int version); 257 extern void net_instance_free(net_instance_t *); 258 extern int net_instance_register(net_instance_t *); 259 extern int net_instance_unregister(net_instance_t *); 260 extern int net_instance_notify_register(netid_t, hook_notify_fn_t, void *); 261 extern int net_instance_notify_unregister(netid_t netid, hook_notify_fn_t); 262 263 extern kstat_t *net_kstat_create(netid_t, char *, int, char *, char *, 264 uchar_t, ulong_t, uchar_t); 265 extern void net_kstat_delete(netid_t, kstat_t *); 266 267 extern net_handle_t net_protocol_lookup(netid_t, const char *); 268 extern net_handle_t net_protocol_register(netid_t, const net_protocol_t *); 269 extern int net_protocol_release(net_handle_t); 270 extern int net_protocol_unregister(net_handle_t); 271 extern net_handle_t net_protocol_walk(netid_t, net_handle_t); 272 extern int net_protocol_notify_register(net_handle_t, hook_notify_fn_t, void *); 273 extern int net_protocol_notify_unregister(net_handle_t, hook_notify_fn_t); 274 275 276 extern int net_getifname(net_handle_t, phy_if_t, char *, const size_t); 277 extern int net_getmtu(net_handle_t, phy_if_t, lif_if_t); 278 extern int net_getpmtuenabled(net_handle_t); 279 extern int net_getlifaddr(net_handle_t, phy_if_t, lif_if_t, 280 int, net_ifaddr_t [], void *); 281 extern zoneid_t net_getlifzone(net_handle_t, phy_if_t, lif_if_t, zoneid_t *); 282 extern int net_getlifflags(net_handle_t, phy_if_t, lif_if_t, uint64_t *); 283 extern phy_if_t net_phygetnext(net_handle_t, phy_if_t); 284 extern phy_if_t net_phylookup(net_handle_t, const char *); 285 extern lif_if_t net_lifgetnext(net_handle_t, phy_if_t, lif_if_t); 286 extern phy_if_t net_routeto(net_handle_t, struct sockaddr *, 287 struct sockaddr *); 288 extern int net_ispartialchecksum(net_handle_t, mblk_t *); 289 extern int net_isvalidchecksum(net_handle_t, mblk_t *); 290 291 #ifdef __cplusplus 292 } 293 #endif 294 295 #endif /* _SYS_NETI_H */ 296