1232950Stheraven/* $NetBSD$ */ 2232950Stheraven 3232950Stheraven/* 4232950Stheraven * Copyright (C) 2004-2007, 2009 Internet Systems Consortium, Inc. ("ISC") 5232950Stheraven * Copyright (C) 1998-2002 Internet Software Consortium. 6232950Stheraven * 7232950Stheraven * Permission to use, copy, modify, and/or distribute this software for any 8232950Stheraven * purpose with or without fee is hereby granted, provided that the above 9232950Stheraven * copyright notice and this permission notice appear in all copies. 10232950Stheraven * 11232950Stheraven * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH 12232950Stheraven * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 13232950Stheraven * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, 14232950Stheraven * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM 15232950Stheraven * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE 16232950Stheraven * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 17232950Stheraven * PERFORMANCE OF THIS SOFTWARE. 18232950Stheraven */ 19232950Stheraven 20232950Stheraven/* Id: netaddr.h,v 1.37 2009/01/17 23:47:43 tbox Exp */ 21232950Stheraven 22232950Stheraven#ifndef ISC_NETADDR_H 23232950Stheraven#define ISC_NETADDR_H 1 24232950Stheraven 25232950Stheraven/*! \file isc/netaddr.h */ 26232950Stheraven 27227825Stheraven#include <isc/lang.h> 28227825Stheraven#include <isc/net.h> 29227825Stheraven#include <isc/types.h> 30227825Stheraven 31227825Stheraven#ifdef ISC_PLATFORM_HAVESYSUNH 32227825Stheraven#include <sys/types.h> 33227825Stheraven#include <sys/un.h> 34227825Stheraven#endif 35227825Stheraven 36227825StheravenISC_LANG_BEGINDECLS 37227825Stheraven 38227825Stheravenstruct isc_netaddr { 39250241Sdim unsigned int family; 40227825Stheraven union { 41232950Stheraven struct in_addr in; 42227825Stheraven struct in6_addr in6; 43227825Stheraven#ifdef ISC_PLATFORM_HAVESYSUNH 44227825Stheraven char un[sizeof(((struct sockaddr_un *)0)->sun_path)]; 45227825Stheraven#endif 46227825Stheraven } type; 47227825Stheraven isc_uint32_t zone; 48227825Stheraven}; 49227825Stheraven 50227825Stheravenisc_boolean_t 51227825Stheravenisc_netaddr_equal(const isc_netaddr_t *a, const isc_netaddr_t *b); 52227825Stheraven 53227825Stheraven/*%< 54227825Stheraven * Compare network addresses 'a' and 'b'. Return #ISC_TRUE if 55227825Stheraven * they are equal, #ISC_FALSE if not. 56227825Stheraven */ 57227825Stheraven 58227825Stheravenisc_boolean_t 59227825Stheravenisc_netaddr_eqprefix(const isc_netaddr_t *a, const isc_netaddr_t *b, 60227825Stheraven unsigned int prefixlen); 61227825Stheraven/*%< 62227825Stheraven * Compare the 'prefixlen' most significant bits of the network 63227825Stheraven * addresses 'a' and 'b'. If 'b''s scope is zero then 'a''s scope is 64250241Sdim * ignored. Return #ISC_TRUE if they are equal, #ISC_FALSE if not. 65227825Stheraven */ 66250241Sdim 67250241Sdimisc_result_t 68250241Sdimisc_netaddr_masktoprefixlen(const isc_netaddr_t *s, unsigned int *lenp); 69250241Sdim/*%< 70250241Sdim * Convert a netmask in 's' into a prefix length in '*lenp'. 71227825Stheraven * The mask should consist of zero or more '1' bits in the most 72227825Stheraven * most significant part of the address, followed by '0' bits. 73227825Stheraven * If this is not the case, #ISC_R_MASKNONCONTIG is returned. 74227825Stheraven * 75227825Stheraven * Returns: 76227825Stheraven *\li #ISC_R_SUCCESS 77250241Sdim *\li #ISC_R_MASKNONCONTIG 78250241Sdim */ 79250241Sdim 80250241Sdimisc_result_t 81227825Stheravenisc_netaddr_totext(const isc_netaddr_t *netaddr, isc_buffer_t *target); 82227825Stheraven/*%< 83227825Stheraven * Append a text representation of 'sockaddr' to the buffer 'target'. 84250241Sdim * The text is NOT null terminated. Handles IPv4 and IPv6 addresses. 85250241Sdim * 86227825Stheraven * Returns: 87250241Sdim *\li #ISC_R_SUCCESS 88227825Stheraven *\li #ISC_R_NOSPACE The text or the null termination did not fit. 89227825Stheraven *\li #ISC_R_FAILURE Unspecified failure 90227825Stheraven */ 91227825Stheraven 92227825Stheravenvoid 93227825Stheravenisc_netaddr_format(const isc_netaddr_t *na, char *array, unsigned int size); 94227825Stheraven/*%< 95227825Stheraven * Format a human-readable representation of the network address '*na' 96227825Stheraven * into the character array 'array', which is of size 'size'. 97227825Stheraven * The resulting string is guaranteed to be null-terminated. 98227825Stheraven */ 99227825Stheraven 100227825Stheraven#define ISC_NETADDR_FORMATSIZE \ 101227825Stheraven sizeof("xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:XXX.XXX.XXX.XXX%SSSSSSSSSS") 102253222Sdim/*%< 103253222Sdim * Minimum size of array to pass to isc_netaddr_format(). 104253222Sdim */ 105253222Sdim 106253222Sdimvoid 107253222Sdimisc_netaddr_fromsockaddr(isc_netaddr_t *netaddr, const isc_sockaddr_t *source); 108250241Sdim 109227825Stheravenvoid 110227825Stheravenisc_netaddr_fromin(isc_netaddr_t *netaddr, const struct in_addr *ina); 111227825Stheraven 112227825Stheravenvoid 113227825Stheravenisc_netaddr_fromin6(isc_netaddr_t *netaddr, const struct in6_addr *ina6); 114253222Sdim 115253222Sdimisc_result_t 116253222Sdimisc_netaddr_frompath(isc_netaddr_t *netaddr, const char *path); 117227825Stheraven 118227825Stheravenvoid 119227825Stheravenisc_netaddr_setzone(isc_netaddr_t *netaddr, isc_uint32_t zone); 120227825Stheraven 121227825Stheravenisc_uint32_t 122227825Stheravenisc_netaddr_getzone(const isc_netaddr_t *netaddr); 123227825Stheraven 124253222Sdimvoid 125253222Sdimisc_netaddr_any(isc_netaddr_t *netaddr); 126253222Sdim/*%< 127227825Stheraven * Return the IPv4 wildcard address. 128227825Stheraven */ 129227825Stheraven 130227825Stheravenvoid 131227825Stheravenisc_netaddr_any6(isc_netaddr_t *netaddr); 132227825Stheraven/*%< 133253222Sdim * Return the IPv6 wildcard address. 134227825Stheraven */ 135253222Sdim 136253222Sdimisc_boolean_t 137253222Sdimisc_netaddr_ismulticast(isc_netaddr_t *na); 138253222Sdim/*%< 139253222Sdim * Returns ISC_TRUE if the address is a multicast address. 140253222Sdim */ 141253222Sdim 142253222Sdimisc_boolean_t 143253222Sdimisc_netaddr_isexperimental(isc_netaddr_t *na); 144253222Sdim/*%< 145253222Sdim * Returns ISC_TRUE if the address is a experimental (CLASS E) address. 146253222Sdim */ 147253222Sdim 148253222Sdimisc_boolean_t 149253222Sdimisc_netaddr_islinklocal(isc_netaddr_t *na); 150253222Sdim/*%< 151227825Stheraven * Returns #ISC_TRUE if the address is a link local address. 152227825Stheraven */ 153227825Stheraven 154227825Stheravenisc_boolean_t 155isc_netaddr_issitelocal(isc_netaddr_t *na); 156/*%< 157 * Returns #ISC_TRUE if the address is a site local address. 158 */ 159 160void 161isc_netaddr_fromv4mapped(isc_netaddr_t *t, const isc_netaddr_t *s); 162/*%< 163 * Convert an IPv6 v4mapped address into an IPv4 address. 164 */ 165 166isc_result_t 167isc_netaddr_prefixok(const isc_netaddr_t *na, unsigned int prefixlen); 168/* 169 * Test whether the netaddr 'na' and 'prefixlen' are consistant. 170 * e.g. prefixlen within range. 171 * na does not have bits set which are not covered by the prefixlen. 172 * 173 * Returns: 174 * ISC_R_SUCCESS 175 * ISC_R_RANGE prefixlen out of range 176 * ISC_R_NOTIMPLEMENTED unsupported family 177 * ISC_R_FAILURE extra bits. 178 */ 179 180ISC_LANG_ENDDECLS 181 182#endif /* ISC_NETADDR_H */ 183