X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=adns.git;a=blobdiff_plain;f=src%2Fadns.h;h=3c06ff6090430a4622c4568f9ec9758bc6e3358f;hp=afcb6b4ba577047d04f1e59b58b4e8e21a0e321b;hb=4b707d8b1701aec2cec7431d4656f771b96a9f00;hpb=828d89bd4196ad8ef825cdf2db26afe2eb797b69 diff --git a/src/adns.h b/src/adns.h index afcb6b4..3c06ff6 100644 --- a/src/adns.h +++ b/src/adns.h @@ -30,6 +30,8 @@ #include #include +/* All struct in_addr anywhere in adns are in NETWORK byte order. */ + typedef struct adns__state *adns_state; typedef struct adns__query *adns_query; @@ -39,6 +41,7 @@ typedef enum { adns_if_noserverwarn= 0x0004, /* do not warn to stderr about duff nameservers etc */ adns_if_debug= 0x0008, /* enable all output to stderr plus debug msgs */ adns_if_noautosys= 0x0010, /* do not make syscalls at every opportunity */ + adns_if_eintr= 0x0020, /* allow _wait and _synchronous to return EINTR */ } adns_initflags; typedef enum { @@ -101,29 +104,48 @@ typedef enum { */ typedef enum { - /* fixme: think about error codes */ adns_s_ok, + + /* locally induced errors */ + adns_s_nomemory, + adns_s_unknownrrtype, + + /* remotely induced errors, detected locally */ adns_s_timeout, - adns_s_nolocalmem, adns_s_allservfail, - adns_s_servfail, - adns_s_notimplemented, - adns_s_refused, - adns_s_reasonunknown, adns_s_norecurse, - adns_s_serverfaulty, - adns_s_unknownreply, - adns_s_invaliddata, + adns_s_invalidresponse, + adns_s_unknownformat, + + /* remotely induced errors, reported by remote server to us */ + adns_s_rcodeservfail, + adns_s_rcodeformaterror, + adns_s_rcodenotimplemented, + adns_s_rcoderefused, + adns_s_rcodeunknown, + adns_s_max_tempfail= 99, - adns_s_inconsistent, /* PTR gives domain whose A does not match */ - adns_s_cname, /* CNAME found where data eg A expected (not if _qf_loosecname) */ - adns_s_invalidanswerdomain, - /* fixme: implement _s_cname */ - adns_s_max_remotemisconfig= 199, + + /* remote configuration errors */ + adns_s_inconsistent, /* PTR gives domain whose A does not exist and match */ + adns_s_prohibitedcname, /* CNAME found where eg A expected (not if _qf_loosecname) */ + adns_s_answerdomaininvalid, + adns_s_answerdomaintoolong, + adns_s_invaliddata, + + adns_s_max_misconfig= 199, + + /* permanent problems with the query */ + adns_s_querydomainwrong, + adns_s_querydomaininvalid, + adns_s_querydomaintoolong, + + adns_s_max_misquery= 299, + + /* permanent errors */ adns_s_nxdomain, adns_s_nodata, - adns_s_invalidquerydomain, - adns_s_domaintoolong, + } adns_status; typedef struct { @@ -132,23 +154,23 @@ typedef struct { struct sockaddr sa; struct sockaddr_in inet; } addr; -} adns_addr; +} adns_rr_addr; typedef struct { - char *dm; + char *host; adns_status astatus; int naddrs; /* temp fail => -1, perm fail => 0, s_ok => >0 */ - adns_addr *addrs; -} adns_rr_dmaddr; + adns_rr_addr *addrs; +} adns_rr_hostaddr; typedef struct { - char *a, *b; + char *(array[2]); } adns_rr_strpair; typedef struct { int i; - adns_rr_dmaddr dmaddr; -} adns_rr_intdmaddr; + adns_rr_hostaddr ha; +} adns_rr_inthostaddr; typedef struct { /* Used both for mx_raw, in which case i is the preference and str the domain, @@ -161,7 +183,11 @@ typedef struct { } adns_rr_intstr; typedef struct { - char *ns0, *rp; + adns_rr_intstr array[2]; +} adns_rr_intstrpair; + +typedef struct { + char *mname, *rname; unsigned long serial, refresh, retry, expire, minimum; } adns_rr_soa; @@ -173,15 +199,16 @@ typedef struct { union { void *untyped; unsigned char *bytes; - char *(*str); /* ns_raw, cname, ptr, ptr_raw */ - adns_rr_intstr *(*manyistr); /* txt (list of strings ends with i=-1, str=0) */ - adns_addr *addr; /* addr */ - struct in_addr *inaddr; /* a */ - adns_rr_dmaddr *dmaddr; /* ns */ - adns_rr_strpair *strpair; /* hinfo ??fixme, rp, rp_raw */ - adns_rr_intdmaddr *intdmaddr; /* mx */ - adns_rr_intstr *intstr; /* mx_raw */ - adns_rr_soa *soa; /* soa, soa_raw */ + char *(*str); /* ns_raw, cname, ptr, ptr_raw */ + adns_rr_intstr *(*manyistr); /* txt (list of strings ends with i=-1, str=0) */ + adns_rr_addr *addr; /* addr */ + struct in_addr *inaddr; /* a */ + adns_rr_hostaddr *hostaddr; /* ns */ + adns_rr_intstrpair *intstrpair; /* hinfo */ + adns_rr_strpair *strpair; /* rp, rp_raw */ + adns_rr_inthostaddr *inthostaddr; /* mx */ + adns_rr_intstr *intstr; /* mx_raw */ + adns_rr_soa *soa; /* soa, soa_raw */ } rrs; } adns_answer; @@ -208,14 +235,17 @@ typedef struct { * If no (appropriate) requests are outstanding adns_query and adns_wait return ESRCH; */ -int adns_init(adns_state *newstate_r, adns_initflags flags, FILE *diagfile/*0=>stderr*/); +int adns_init(adns_state *newstate_r, adns_initflags flags, + FILE *diagfile /*0=>stderr*/); + +int adns_init_strcfg(adns_state *newstate_r, adns_initflags flags, + FILE *diagfile /*0=>discard*/, const char *configtext); int adns_synchronous(adns_state ads, const char *owner, adns_rrtype type, adns_queryflags flags, adns_answer **answer_r); -/* Will not return EINTR. */ /* NB: if you set adns_if_noautosys then _submit and _check do not * make any system calls; you must use adns_callback (possibly after @@ -238,11 +268,10 @@ int adns_wait(adns_state ads, adns_query *query_io, adns_answer **answer_r, void **context_r); -/* Might return EINTR - if so, try again */ void adns_cancel(adns_query query); -int adns_finish(adns_state); +void adns_finish(adns_state); /* You may call this even if you have queries outstanding; * they will be cancelled. */ @@ -316,7 +345,7 @@ adns_status adns_rr_info(adns_rrtype type, * * Usually this routine will succeed. Possible errors include: * adns_s_nomemory - * adns_s_notimplemented (RR type not known) + * adns_s_rrtypeunknown * adns_s_invaliddata (*datap contained garbage) * If an error occurs then no memory has been allocated, * and *rrtname_r, *fmtname_r, *len_r and *data_r are undefined.