1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ 2 /* 3 * The contents of this file are subject to the Mozilla Public 4 * License Version 1.1 (the "License"); you may not use this file 5 * except in compliance with the License. You may obtain a copy of 6 * the License at http://www.mozilla.org/MPL/ 7 * 8 * Software distributed under the License is distributed on an "AS 9 * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or 10 * implied. See the License for the specific language governing 11 * rights and limitations under the License. 12 * 13 * The Original Code is the Netscape Portable Runtime (NSPR). 14 * 15 * The Initial Developer of the Original Code is Netscape 16 * Communications Corporation. Portions created by Netscape are 17 * Copyright (C) 1998-2000 Netscape Communications Corporation. All 18 * Rights Reserved. 19 * 20 * Contributor(s): 21 * 22 * Alternatively, the contents of this file may be used under the 23 * terms of the GNU General Public License Version 2 or later (the 24 * "GPL"), in which case the provisions of the GPL are applicable 25 * instead of those above. If you wish to allow use of your 26 * version of this file only under the terms of the GPL and not to 27 * allow others to use your version of this file under the MPL, 28 * indicate your decision by deleting the provisions above and 29 * replace them with the notice and other provisions required by 30 * the GPL. If you do not delete the provisions above, a recipient 31 * may use your version of this file under either the MPL or the 32 * GPL. 33 */ 34 35 /* 36 * plresolv.h - asynchronous name resolution using DNS 37 */ 38 39 #ifndef _PLRESOLV_H_ 40 #define _PLRESOLV_H_ 41 42 /* 43 ** THIS IS WORK IN PROGRESS. DO NOT ATTEMPT TO USE ANY PORTION OF THIS 44 ** API UNTIL THIS MESSAGE NO LONGER EXISTS. IF YOU DO, THEN YOU SURRENDER 45 ** THE RIGHT TO COMPLAIN ABOUT ANY CONTENT. 46 */ 47 48 #if defined(XP_UNIX) 49 50 #include <prtypes.h> 51 #include <prnetdb.h> 52 53 NSPR_BEGIN_EXTERN_C 54 55 #define PL_RESOLVE_MAXHOSTENTBUF 1024 56 #define PL_RESOLVE_DEFAULT_TIMEOUT 0 57 58 /* Error return codes */ 59 #define PL_RESOLVE_OK 0 60 #define PL_RESOLVE_EWINIT 1 /* Failed to initialize window */ 61 #define PL_RESOLVE_EMAKE 2 /* Failed to create request */ 62 #define PL_RESOLVE_ELAUNCH 3 /* Error launching Async request */ 63 #define PL_RESOLVE_ETIMEDOUT 4 /* Request timed-out */ 64 #define PL_RESOLVE_EINVAL 5 /* Invalid argument */ 65 #define PL_RESOLVE_EOVERFLOW 6 /* Buffer Overflow */ 66 #define PL_RESOLVE_EUNKNOWN 7 /* berzerk error */ 67 68 /* ----------- Function Prototypes ----------------*/ 69 70 PR_EXTERN(PRStatus) PL_ResolveName( 71 const char *name, unsigned char *buf, 72 PRIntn bufsize, PRIntervalTime timeout, 73 PRHostEnt *hostentry, PRIntervalTime *ttl); 74 75 PR_EXTERN(PRStatus) PL_ResolveAddr( 76 const PRNetAddr *address, unsigned char *buf, 77 PRIntn bufsize, PRIntervalTime timeout, 78 PRHostEnt *hostentry, PRIntervalTime *ttl); 79 80 typedef struct PLResolveStats { 81 int re_errors; 82 int re_nu_look; 83 int re_na_look; 84 int re_replies; 85 int re_requests; 86 int re_resends; 87 int re_sent; 88 int re_timeouts; 89 } PLResolveStats; 90 91 typedef struct PLResoveInfo { 92 PRBool enabled; 93 PRUint32 numNameLookups; 94 PRUint32 numAddrLookups; 95 PRUint32 numLookupsInProgress; 96 PLResolveStats stats; 97 } PLResoveInfo; 98 99 PR_EXTERN(void) PL_ResolveInfo(PLResoveInfo *info); 100 101 NSPR_END_EXTERN_C 102 103 #endif /* defined(XP_UNIX) */ 104 105 #endif /* _PLRESOLV_H_ */ 106