contrib/bind-9.3/lib/isc/unix/include/isc/net.h

   1 /*
   2  * Copyright (C) 2004  Internet Systems Consortium, Inc. ("ISC")
   3  * Copyright (C) 1999-2003  Internet Software Consortium.
   4  *
   5  * Permission to use, copy, modify, and distribute this software for any
   6  * purpose with or without fee is hereby granted, provided that the above
   7  * copyright notice and this permission notice appear in all copies.
   8  *
   9  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  10  * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  11  * AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  12  * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  13  * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  14  * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  15  * PERFORMANCE OF THIS SOFTWARE.
  16  */
  17
  18 /* $Id: net.h,v 1.31.2.2.10.8 2004/04/29 01:31:23 marka Exp $ */
  19
  20 #ifndef ISC_NET_H
  21 #define ISC_NET_H 1
  22
  23 /*****
  24  ***** Module Info
  25  *****/
  26
  27 /*
  28  * Basic Networking Types
  29  *
  30  * This module is responsible for defining the following basic networking
  31  * types:
  32  *
  33  *              struct in_addr
  34  *              struct in6_addr
  35  *              struct in6_pktinfo
  36  *              struct sockaddr
  37  *              struct sockaddr_in
  38  *              struct sockaddr_in6
  39  *              in_port_t
  40  *
  41  * It ensures that the AF_ and PF_ macros are defined.
  42  *
  43  * It declares ntoh[sl]() and hton[sl]().
  44  *
  45  * It declares inet_aton(), inet_ntop(), and inet_pton().
  46  *
  47  * It ensures that INADDR_LOOPBACK, INADDR_ANY, IN6ADDR_ANY_INIT,
  48  * in6addr_any, and in6addr_loopback are available.
  49  *
  50  * It ensures that IN_MULTICAST() is available to check for multicast
  51  * addresses.
  52  *
  53  * MP:
  54  *      No impact.
  55  *
  56  * Reliability:
  57  *      No anticipated impact.
  58  *
  59  * Resources:
  60  *      N/A.
  61  *
  62  * Security:
  63  *      No anticipated impact.
  64  *
  65  * Standards:
  66  *      BSD Socket API
  67  *      RFC 2553
  68  */
  69
  70 /***
  71  *** Imports.
  72  ***/
  73 #include <isc/platform.h>
  74
  75 #include <sys/types.h>
  76 #include <sys/socket.h>         /* Contractual promise. */
  77
  78 #include <net/if.h>
  79
  80 #include <netinet/in.h>         /* Contractual promise. */
  81 #include <arpa/inet.h>          /* Contractual promise. */
  82 #ifdef ISC_PLATFORM_NEEDNETINETIN6H
  83 #include <netinet/in6.h>        /* Required on UnixWare. */
  84 #endif
  85 #ifdef ISC_PLATFORM_NEEDNETINET6IN6H
  86 #include <netinet6/in6.h>       /* Required on BSD/OS for in6_pktinfo. */
  87 #endif
  88
  89 #ifndef ISC_PLATFORM_HAVEIPV6
  90 #include <isc/ipv6.h>           /* Contractual promise. */
  91 #endif
  92
  93 #include <isc/lang.h>
  94 #include <isc/types.h>
  95
  96 #ifdef ISC_PLATFORM_HAVEINADDR6
  97 #define in6_addr in_addr6       /* Required for pre RFC2133 implementations. */
  98 #endif
  99
 100 #ifdef ISC_PLATFORM_HAVEIPV6
 101 /*
 102  * Required for some pre RFC2133 implementations.
 103  * IN6ADDR_ANY_INIT and IN6ADDR_LOOPBACK_INIT were added in
 104  * draft-ietf-ipngwg-bsd-api-04.txt or draft-ietf-ipngwg-bsd-api-05.txt.
 105  * If 's6_addr' is defined then assume that there is a union and three
 106  * levels otherwise assume two levels required.
 107  */
 108 #ifndef IN6ADDR_ANY_INIT
 109 #ifdef s6_addr
 110 #define IN6ADDR_ANY_INIT { { { 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 } } }
 111 #else
 112 #define IN6ADDR_ANY_INIT { { 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 } }
 113 #endif
 114 #endif
 115
 116 #ifndef IN6ADDR_LOOPBACK_INIT
 117 #ifdef s6_addr
 118 #define IN6ADDR_LOOPBACK_INIT { { { 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1 } } }
 119 #else
 120 #define IN6ADDR_LOOPBACK_INIT { { 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1 } }
 121 #endif
 122 #endif
 123
 124 #ifndef IN6_IS_ADDR_V4MAPPED
 125 #define IN6_IS_ADDR_V4MAPPED(x) \
 126          (memcmp((x)->s6_addr, in6addr_any.s6_addr, 10) == 0 && \
 127           (x)->s6_addr[10] == 0xff && (x)->s6_addr[11] == 0xff)
 128 #endif
 129
 130 #ifndef IN6_IS_ADDR_V4COMPAT
 131 #define IN6_IS_ADDR_V4COMPAT(x) \
 132          (memcmp((x)->s6_addr, in6addr_any.s6_addr, 12) == 0 && \
 133          ((x)->s6_addr[12] != 0 || (x)->s6_addr[13] != 0 || \
 134           (x)->s6_addr[14] != 0 || \
 135           ((x)->s6_addr[15] != 0 && (x)->s6_addr[15] != 1)))
 136 #endif
 137
 138 #ifndef IN6_IS_ADDR_MULTICAST
 139 #define IN6_IS_ADDR_MULTICAST(a)        ((a)->s6_addr[0] == 0xff)
 140 #endif
 141
 142 #ifndef IN6_IS_ADDR_LINKLOCAL
 143 #define IN6_IS_ADDR_LINKLOCAL(a) \
 144         (((a)->s6_addr[0] == 0xfe) && (((a)->s6_addr[1] & 0xc0) == 0x80))
 145 #endif
 146
 147 #ifndef IN6_IS_ADDR_SITELOCAL
 148 #define IN6_IS_ADDR_SITELOCAL(a) \
 149         (((a)->s6_addr[0] == 0xfe) && (((a)->s6_addr[1] & 0xc0) == 0xc0))
 150 #endif
 151
 152
 153 #ifndef IN6_IS_ADDR_LOOPBACK
 154 #define IN6_IS_ADDR_LOOPBACK(x) \
 155         (memcmp((x)->s6_addr, in6addr_loopback.s6_addr, 16) == 0)
 156 #endif
 157 #endif
 158
 159 #ifndef AF_INET6
 160 #define AF_INET6 99
 161 #endif
 162
 163 #ifndef PF_INET6
 164 #define PF_INET6 AF_INET6
 165 #endif
 166
 167 #ifndef INADDR_LOOPBACK
 168 #define INADDR_LOOPBACK 0x7f000001UL
 169 #endif
 170
 171 #ifndef ISC_PLATFORM_HAVEIN6PKTINFO
 172 struct in6_pktinfo {
 173         struct in6_addr ipi6_addr;    /* src/dst IPv6 address */
 174         unsigned int    ipi6_ifindex; /* send/recv interface index */
 175 };
 176 #endif
 177
 178 /*
 179  * Cope with a missing in6addr_any and in6addr_loopback.
 180  */
 181 #if defined(ISC_PLATFORM_HAVEIPV6) && defined(ISC_PLATFORM_NEEDIN6ADDRANY)
 182 extern const struct in6_addr isc_net_in6addrany;
 183 #define in6addr_any isc_net_in6addrany
 184 #endif
 185
 186 #if defined(ISC_PLATFORM_HAVEIPV6) && defined(ISC_PLATFORM_NEEDIN6ADDRLOOPBACK)
 187 extern const struct in6_addr isc_net_in6addrloop;
 188 #define in6addr_loopback isc_net_in6addrloop
 189 #endif
 190
 191 /*
 192  * Fix UnixWare 7.1.1's broken IN6_IS_ADDR_* definitions.
 193  */
 194 #ifdef ISC_PLATFORM_FIXIN6ISADDR
 195 #undef  IN6_IS_ADDR_GEOGRAPHIC
 196 #define IN6_IS_ADDR_GEOGRAPHIC(a) (((a)->S6_un.S6_l[0] & 0xE0) == 0x80)
 197 #undef  IN6_IS_ADDR_IPX
 198 #define IN6_IS_ADDR_IPX(a)        (((a)->S6_un.S6_l[0] & 0xFE) == 0x04)
 199 #undef  IN6_IS_ADDR_LINKLOCAL
 200 #define IN6_IS_ADDR_LINKLOCAL(a)  (((a)->S6_un.S6_l[0] & 0xC0FF) == 0x80FE)
 201 #undef  IN6_IS_ADDR_MULTICAST
 202 #define IN6_IS_ADDR_MULTICAST(a)  (((a)->S6_un.S6_l[0] & 0xFF) == 0xFF)
 203 #undef  IN6_IS_ADDR_NSAP
 204 #define IN6_IS_ADDR_NSAP(a)       (((a)->S6_un.S6_l[0] & 0xFE) == 0x02)
 205 #undef  IN6_IS_ADDR_PROVIDER
 206 #define IN6_IS_ADDR_PROVIDER(a)   (((a)->S6_un.S6_l[0] & 0xE0) == 0x40)
 207 #undef  IN6_IS_ADDR_SITELOCAL
 208 #define IN6_IS_ADDR_SITELOCAL(a)  (((a)->S6_un.S6_l[0] & 0xC0FF) == 0xC0FE)
 209 #endif /* ISC_PLATFORM_FIXIN6ISADDR */
 210
 211 /*
 212  * Ensure type in_port_t is defined.
 213  */
 214 #ifdef ISC_PLATFORM_NEEDPORTT
 215 typedef isc_uint16_t in_port_t;
 216 #endif
 217
 218 /*
 219  * If this system does not have MSG_TRUNC (as returned from recvmsg())
 220  * ISC_PLATFORM_RECVOVERFLOW will be defined.  This will enable the MSG_TRUNC
 221  * faking code in socket.c.
 222  */
 223 #ifndef MSG_TRUNC
 224 #define ISC_PLATFORM_RECVOVERFLOW
 225 #endif
 226
 227 #define ISC__IPADDR(x)  ((isc_uint32_t)htonl((isc_uint32_t)(x)))
 228
 229 #define ISC_IPADDR_ISMULTICAST(i) \
 230                 (((isc_uint32_t)(i) & ISC__IPADDR(0xf0000000)) \
 231                  == ISC__IPADDR(0xe0000000))
 232
 233 #define ISC_IPADDR_ISEXPERIMENTAL(i) \
 234                 (((isc_uint32_t)(i) & ISC__IPADDR(0xf0000000)) \
 235                  == ISC__IPADDR(0xf0000000))
 236
 237 /***
 238  *** Functions.
 239  ***/
 240
 241 ISC_LANG_BEGINDECLS
 242
 243 isc_result_t
 244 isc_net_probeipv4(void);
 245 /*
 246  * Check if the system's kernel supports IPv4.
 247  *
 248  * Returns:
 249  *
 250  *      ISC_R_SUCCESS           IPv4 is supported.
 251  *      ISC_R_NOTFOUND          IPv4 is not supported.
 252  *      ISC_R_DISABLED          IPv4 is disabled.
 253  *      ISC_R_UNEXPECTED
 254  */
 255
 256 isc_result_t
 257 isc_net_probeipv6(void);
 258 /*
 259  * Check if the system's kernel supports IPv6.
 260  *
 261  * Returns:
 262  *
 263  *      ISC_R_SUCCESS           IPv6 is supported.
 264  *      ISC_R_NOTFOUND          IPv6 is not supported.
 265  *      ISC_R_DISABLED          IPv6 is disabled.
 266  *      ISC_R_UNEXPECTED
 267  */
 268
 269 isc_result_t
 270 isc_net_probe_ipv6only(void);
 271 /*
 272  * Check if the system's kernel supports the IPV6_V6ONLY socket option.
 273  *
 274  * Returns:
 275  *
 276  *      ISC_R_SUCCESS           the option is supported for both TCP and UDP.
 277  *      ISC_R_NOTFOUND          IPv6 itself or the option is not supported.
 278  *      ISC_R_UNEXPECTED
 279  */
 280
 281 isc_result_t
 282 isc_net_probe_ipv6pktinfo(void);
 283 /*
 284  * Check if the system's kernel supports the IPV6_(RECV)PKTINFO socket option
 285  * for UDP sockets.
 286  *
 287  * Returns:
 288  *
 289  *      ISC_R_SUCCESS           the option is supported.
 290  *      ISC_R_NOTFOUND          IPv6 itself or the option is not supported.
 291  *      ISC_R_UNEXPECTED
 292  */
 293
 294 void
 295 isc_net_disableipv4(void);
 296
 297 void
 298 isc_net_disableipv6(void);
 299
 300 void
 301 isc_net_enableipv4(void);
 302
 303 void
 304 isc_net_enableipv6(void);
 305
 306 #ifdef ISC_PLATFORM_NEEDNTOP
 307 const char *
 308 isc_net_ntop(int af, const void *src, char *dst, size_t size);
 309 #define inet_ntop isc_net_ntop
 310 #endif
 311
 312 #ifdef ISC_PLATFORM_NEEDPTON
 313 int
 314 isc_net_pton(int af, const char *src, void *dst);
 315 #undef inet_pton
 316 #define inet_pton isc_net_pton
 317 #endif
 318
 319 #ifdef ISC_PLATFORM_NEEDATON
 320 int
 321 isc_net_aton(const char *cp, struct in_addr *addr);
 322 #define inet_aton isc_net_aton
 323 #endif
 324
 325 ISC_LANG_ENDDECLS
 326
 327 #endif /* ISC_NET_H */