byaddr.h (170223) | byaddr.h (193149) |
---|---|
1/* | 1/* |
2 * Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") | 2 * Copyright (C) 2004-2007 Internet Systems Consortium, Inc. ("ISC") |
3 * Copyright (C) 2000-2003 Internet Software Consortium. 4 * | 3 * Copyright (C) 2000-2003 Internet Software Consortium. 4 * |
5 * Permission to use, copy, modify, and distribute this software for any | 5 * Permission to use, copy, modify, and/or 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 | 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: byaddr.h,v 1.16.18.2 2005/04/29 00:16:09 marka Exp $ */ | 18/* $Id: byaddr.h,v 1.22 2007/06/19 23:47:16 tbox Exp $ */ |
19 20#ifndef DNS_BYADDR_H 21#define DNS_BYADDR_H 1 22 23/***** 24 ***** Module Info 25 *****/ 26 | 19 20#ifndef DNS_BYADDR_H 21#define DNS_BYADDR_H 1 22 23/***** 24 ***** Module Info 25 *****/ 26 |
27/*! \file | 27/*! \file dns/byaddr.h |
28 * \brief 29 * The byaddr module provides reverse lookup services for IPv4 and IPv6 30 * addresses. 31 * 32 * MP: 33 *\li The module ensures appropriate synchronization of data structures it 34 * creates and manipulates. 35 * --- 80 unchanged lines hidden (view full) --- 116 117void 118dns_byaddr_cancel(dns_byaddr_t *byaddr); 119/*%< 120 * Cancel 'byaddr'. 121 * 122 * Notes: 123 * | 28 * \brief 29 * The byaddr module provides reverse lookup services for IPv4 and IPv6 30 * addresses. 31 * 32 * MP: 33 *\li The module ensures appropriate synchronization of data structures it 34 * creates and manipulates. 35 * --- 80 unchanged lines hidden (view full) --- 116 117void 118dns_byaddr_cancel(dns_byaddr_t *byaddr); 119/*%< 120 * Cancel 'byaddr'. 121 * 122 * Notes: 123 * |
124 *\li If 'byaddr' has not completed, post its #BYADDRDONE event with a 125 * result code of #ISC_R_CANCELED. | 124 *\li If 'byaddr' has not completed, post its #DNS_EVENT_BYADDRDONE 125 * event with a result code of #ISC_R_CANCELED. |
126 * 127 * Requires: 128 * 129 *\li 'byaddr' is a valid byaddr. 130 */ 131 132void 133dns_byaddr_destroy(dns_byaddr_t **byaddrp); 134/*%< 135 * Destroy 'byaddr'. 136 * 137 * Requires: 138 * 139 *\li '*byaddrp' is a valid byaddr. 140 * | 126 * 127 * Requires: 128 * 129 *\li 'byaddr' is a valid byaddr. 130 */ 131 132void 133dns_byaddr_destroy(dns_byaddr_t **byaddrp); 134/*%< 135 * Destroy 'byaddr'. 136 * 137 * Requires: 138 * 139 *\li '*byaddrp' is a valid byaddr. 140 * |
141 *\li The caller has received the BYADDRDONE event (either because the 142 * byaddr completed or because dns_byaddr_cancel() was called). | 141 *\li The caller has received the #DNS_EVENT_BYADDRDONE event (either because 142 * the byaddr completed or because dns_byaddr_cancel() was called). |
143 * 144 * Ensures: 145 * 146 *\li *byaddrp == NULL. 147 */ 148 149isc_result_t 150dns_byaddr_createptrname(isc_netaddr_t *address, isc_boolean_t nibble, --- 21 unchanged lines hidden --- | 143 * 144 * Ensures: 145 * 146 *\li *byaddrp == NULL. 147 */ 148 149isc_result_t 150dns_byaddr_createptrname(isc_netaddr_t *address, isc_boolean_t nibble, --- 21 unchanged lines hidden --- |