1 /* 2 * Copyright (c) 2000-2010 Apple Inc. All rights reserved. 3 * 4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ 5 * 6 * This file contains Original Code and/or Modifications of Original Code 7 * as defined in and that are subject to the Apple Public Source License 8 * Version 2.0 (the 'License'). You may not use this file except in 9 * compliance with the License. The rights granted to you under the License 10 * may not be used to create, or enable the creation or redistribution of, 11 * unlawful or unlicensed copies of an Apple operating system, or to 12 * circumvent, violate, or enable the circumvention or violation of, any 13 * terms of an Apple operating system software license agreement. 14 * 15 * Please obtain a copy of the License at 16 * http://www.opensource.apple.com/apsl/ and read it before using this file. 17 * 18 * The Original Code and all software distributed under the License are 19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 23 * Please see the License for the specific language governing rights and 24 * limitations under the License. 25 * 26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ 27 */ 28 /* 29 * Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. 30 * All rights reserved. 31 * 32 * Redistribution and use in source and binary forms, with or without 33 * modification, are permitted provided that the following conditions 34 * are met: 35 * 1. Redistributions of source code must retain the above copyright 36 * notice, this list of conditions and the following disclaimer. 37 * 2. Redistributions in binary form must reproduce the above copyright 38 * notice, this list of conditions and the following disclaimer in the 39 * documentation and/or other materials provided with the distribution. 40 * 3. Neither the name of the project nor the names of its contributors 41 * may be used to endorse or promote products derived from this software 42 * without specific prior written permission. 43 * 44 * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND 45 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 46 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 47 * ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE 48 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 49 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 50 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 51 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 52 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 53 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 54 * SUCH DAMAGE. 55 */ 56 /* 57 * glue for kernel code programming differences. 58 */ 59 60 /* 61 * OS dependencies: 62 * 63 * - whether the IPv4 input routine convert the byte order of some fileds 64 * of the IP header (x: convert to the host byte order, s: strip the header 65 * length for possible reassembly) 66 * ip_len ip_id ip_off 67 * bsdi3: xs x x 68 * bsdi4: xs x 69 * FreeBSD: xs x 70 * NetBSD: x x 71 * OpenBSD: xs x x 72 * 73 * - ifa_ifwithaf() 74 * bsdi[34], netbsd, and openbsd define it in sys/net/if.c 75 * freebsd (all versions) does not have it. 76 * 77 * - struct rt_addrinfo 78 * bsdi4, netbsd 1.5R and beyond: rti_addrs, rti_info[], rti_flags, rti_ifa, 79 * rti_ifp, and rti_rtm. 80 * others: rti_addrs and rti_info[] only. 81 * 82 * - ifa->ifa_rtrequest 83 * bsdi4, netbsd 1.5R and beyond: rt_addrinfo * 84 * others: sockaddr * (note that sys/net/route.c:rtrequest() has an unsafe 85 * typecast code, from 4.3BSD-reno) 86 * 87 * - side effects of rtrequest{,1}(RTM_DELETE) 88 * BSDI[34]: delete all cloned routes underneath the route. 89 * FreeBSD[234]: delete all protocol-cloned routes underneath the route. 90 * note that cloned routes from an interface direct route 91 * still remain. 92 * NetBSD: 1.5 have no side effects. KAME/netbsd15, and post-1.5R, have 93 * the same effects as of BSDI. 94 * OpenBSD: have no side effects. KAME/openbsd has the same effects as 95 * of BSDI (the change is not merged - yet). 96 * 97 * - privileged process 98 * NetBSD, FreeBSD 3 99 * struct proc *p; 100 * if (p && !suser(p->p_ucred, &p->p_acflag)) 101 * privileged; 102 * FreeBSD 4 103 * struct proc *p; 104 * if (p && !suser(p)) 105 * privileged; 106 * OpenBSD, BSDI [34], FreeBSD 2 107 * struct socket *so; 108 * if (so->so_state & SS_PRIV) 109 * privileged; 110 * - foo_control 111 * NetBSD, FreeBSD 3 112 * needs to give struct proc * as argument 113 * OpenBSD, BSDI [34], FreeBSD 2 114 * do not need struct proc * 115 * 116 * - bpf: 117 * OpenBSD, NetBSD 1.5, BSDI [34] 118 * need caddr_t * (= if_bpf **) and struct ifnet * 119 * FreeBSD 2, FreeBSD 3, NetBSD post-1.5N 120 * need only struct ifnet * as argument 121 * 122 * - struct ifnet 123 * use queue.h? member names if name 124 * --- --- --- 125 * FreeBSD 2 no old standard if_name+unit 126 * FreeBSD 3 yes strange if_name+unit 127 * OpenBSD yes standard if_xname 128 * NetBSD yes standard if_xname 129 * BSDI [34] no old standard if_name+unit 130 * 131 * - usrreq 132 * NetBSD, OpenBSD, BSDI [34], FreeBSD 2 133 * single function with PRU_xx, arguments are mbuf 134 * FreeBSD 3 135 * separates functions, non-mbuf arguments 136 * 137 * - {set,get}sockopt 138 * NetBSD, OpenBSD, BSDI [34], FreeBSD 2 139 * manipulation based on mbuf 140 * FreeBSD 3 141 * non-mbuf manipulation using sooptcopy{in,out}() 142 * 143 * - timeout() and untimeout() 144 * NetBSD 1.4.x, OpenBSD, BSDI [34], FreeBSD 2 145 * timeout() is a void function 146 * FreeBSD 3 147 * timeout() is non-void, must keep returned value for untimeout() 148 * callout_xx is also available (sys/callout.h) 149 * NetBSD 1.5 150 * timeout() is obsoleted, use callout_xx (sys/callout.h) 151 * OpenBSD 2.8 152 * timeout_{add,set,del} is encouraged (sys/timeout.h) 153 * 154 * - sysctl 155 * NetBSD, OpenBSD 156 * foo_sysctl() 157 * BSDI [34] 158 * foo_sysctl() but with different style. sysctl_int_arr() takes 159 * care of most of the cases. 160 * FreeBSD 161 * linker hack. however, there are freebsd version differences 162 * (how wonderful!). 163 * on FreeBSD[23] function arg #define includes paren. 164 * int foo SYSCTL_HANDLER_ARGS; 165 * on FreeBSD4, function arg #define does not include paren. 166 * int foo(SYSCTL_HANDLER_ARGS); 167 * on some versions, forward reference to the tree is okay. 168 * on some versions, you need SYSCTL_DECL(). you need things 169 * like this. 170 * #ifdef SYSCTL_DECL 171 * SYSCTL_DECL(net_inet_ip6); 172 * #endif 173 * it is hard to share functions between freebsd and non-freebsd. 174 * 175 * - if_ioctl 176 * NetBSD, FreeBSD 3, BSDI [34] 177 * 2nd argument is u_long cmd 178 * FreeBSD 2 179 * 2nd argument is int cmd 180 * 181 * - if attach routines 182 * NetBSD 183 * void xxattach(int); 184 * FreeBSD 2, FreeBSD 3 185 * void xxattach(void *); 186 * PSEUDO_SET(xxattach, if_xx); 187 * 188 * - ovbcopy() 189 * in NetBSD 1.4 or later, ovbcopy() is not supplied in the kernel. 190 * bcopy() is safe against overwrites. 191 * 192 * - splnet() 193 * NetBSD 1.4 or later requires splsoftnet(). 194 * other operating systems use splnet(). 195 * 196 * - dtom() 197 * NEVER USE IT! 198 * 199 * - struct ifnet for loopback interface 200 * BSDI3: struct ifnet loif; 201 * BSDI4: struct ifnet *loifp; 202 * NetBSD, OpenBSD 2.8, FreeBSD2: struct ifnet loif[NLOOP]; 203 * OpenBSD 2.9: struct ifnet *lo0ifp; 204 * 205 * odd thing is that many of them refers loif as ifnet *loif, 206 * not loif[NLOOP], from outside of if_loop.c. 207 * 208 * - number of bpf pseudo devices 209 * others: bpfilter.h, NBPFILTER 210 * FreeBSD4: bpf.h, NBPF 211 * solution: 212 * #if defined(__FreeBSD__) && __FreeBSD__ >= 4 213 * #include "bpf.h" 214 * #define NBPFILTER NBPF 215 * #else 216 * #include "bpfilter.h" 217 * #endif 218 * 219 * - protosw for IPv4 (sys/netinet) 220 * FreeBSD4: struct ipprotosw in netinet/ipprotosw.h 221 * others: struct protosw in sys/protosw.h 222 * 223 * - protosw in general. 224 * NetBSD 1.5 has extra member for ipfilter (netbsd-current dropped 225 * it so it will go away in 1.6). 226 * NetBSD 1.5 requires PR_LISTEN flag bit with protocols that permit 227 * listen/accept (like tcp). 228 * 229 * - header files with defopt (opt_xx.h) 230 * FreeBSD3: opt_{inet,ipsec,ip6fw,altq}.h 231 * FreeBSD4: opt_{inet,inet6,ipsec,ip6fw,altq}.h 232 * NetBSD: opt_{inet,ipsec,altq}.h 233 * others: does not use defopt 234 * 235 * - (m->m_flags & M_EXT) != 0 does *not* mean that the max data length of 236 * the mbuf == MCLBYTES. 237 * 238 * - sys/kern/uipc_mbuf.c:m_dup() 239 * freebsd[34]: copies the whole mbuf chain. 240 * netbsd: similar arg with m_copym(). 241 * others: no m_dup(). 242 * 243 * - ifa_refcnt (struct ifaddr) management (IFAREF/IFAFREE). 244 * NetBSD 1.5: always use IFAREF whenever reference gets added. 245 * always use IFAFREE whenever reference gets freed. 246 * IFAFREE frees ifaddr when ifa_refcnt reaches 0. 247 * Darwin: always use IFA_ADDREF whenever reference gets added. 248 * always use IFA_REMREF whenever reference gets freed. 249 * IFA_ADDREF and IFA_REMREF are responsible for determining 250 * when to free. 251 * others: do not increase refcnt for ifp->if_addrlist and in_ifaddr. 252 * use IFAFREE once when ifaddr is disconnected from 253 * ifp->if_addrlist and in_ifaddr. IFAFREE frees ifaddr when 254 * ifa_refcnt goes negative. 255 */ 256 257 #ifndef __NET_NET_OSDEP_H_DEFINED_ 258 #define __NET_NET_OSDEP_H_DEFINED_ 259 #include <sys/appleapiopts.h> 260 #ifdef KERNEL_PRIVATE 261 262 struct ifnet; 263 264 #define HAVE_OLD_BPF 265 266 #define ifa_list ifa_link 267 #define if_addrlist if_addrhead 268 #define if_list if_link 269 270 #define WITH_CONVERT_AND_STRIP_IP_LEN 271 272 #if 1 /* at this moment, all OSes do this */ 273 #define WITH_CONVERT_IP_OFF 274 #endif 275 276 #endif /* KERNEL_PRIVATE */ 277 #endif /*__NET_NET_OSDEP_H_DEFINED_ */ 278