# Copyright (C) 2011 Internet Systems Consortium, Inc. ("ISC") # # Permission to use, copy, modify, and/or distribute this software for any # purpose with or without fee is hereby granted, provided that the above # copyright notice and this permission notice appear in all copies. # # THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH # REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY # AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, # INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM # LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE # OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. $NAMESPACE isc::resolve % RESLIB_ANSWER answer received in response to query for <%1> A debug message reporting that an answer has been received to an upstream query for the specified question. Previous debug messages will have indicated the server to which the question was sent. % RESLIB_CNAME CNAME received in response to query for <%1> A debug message recording that CNAME response has been received to an upstream query for the specified question. Previous debug messages will have indicated the server to which the question was sent. % RESLIB_DEEPEST did not find <%1> in cache, deepest delegation found is %2 A debug message, a cache lookup did not find the specified tuple in the cache; instead, the deepest delegation found is indicated. % RESLIB_EMPTY_RESPONSE empty response received to query for <%1> A debug message, the response to the specified query from an upstream nameserver did not contain anything in the answer or authority sections, although in all other respects it was a valid response. A SERVFAIL will be returned to the system making the original query. % RESLIB_ERROR_RESPONSE unspecified error received in response to query for <%1> A debug message, the response to the specified query to an upstream nameserver indicated that the response was classified as an erroneous response, but that the nature of the error cannot be identified. A SERVFAIL will be returned to the system making the original query. % RESLIB_EXTRADATA_RESPONSE extra data in response to query for <%1> A debug message indicating that the response to the specified query from an upstream nameserver contained too much data. This can happen if an ANY query was sent and the answer section in the response contained multiple RRs with different names. A SERVFAIL will be returned to the system making the original query. % RESLIB_FOLLOW_CNAME following CNAME chain to <%1> A debug message, a CNAME response was received and another query is being issued for the tuple. % RESLIB_INVALID_NAMECLASS_RESPONSE invalid name or class in response to query for <%1> A debug message, the response to the specified query from an upstream nameserver (as identified by the ID of the response) contained either an answer not matching the query name or an answer having a different class to that queried for. A SERVFAIL will be returned to the system making the original query. % RESLIB_INVALID_QNAME_RESPONSE invalid name or class in response to query for <%1> A debug message, the response to the specified query from an upstream nameserver (as identified by the ID of the response) contained a name in the question section that did not match that of the query. A SERVFAIL will be returned to the system making the original query. % RESLIB_INVALID_TYPE_RESPONSE invalid name or class in response to query for <%1> A debug message, the response to the specified query from an upstream nameserver (as identified by the ID of the response) contained an invalid type field. A SERVFAIL will be returned to the system making the original query. % RESLIB_LONG_CHAIN CNAME received in response to query for <%1>: CNAME chain length exceeded A debug message recording that a CNAME response has been received to an upstream query for the specified question (Previous debug messages will have indicated the server to which the question was sent). However, receipt of this CNAME has meant that the resolver has exceeded the CNAME chain limit (a CNAME chain is where on CNAME points to another) and so an error is being returned. % RESLIB_MULTIPLE_CLASS_RESPONSE response to query for <%1> contained multiple RRsets with different classes A debug message reporting that the response to an upstream query for the specified name contained multiple RRsets in the answer and not all were of the same class. This is a violation of the standard and so a SERVFAIL will be returned. % RESLIB_NOTSINGLE_RESPONSE response to query for <%1> was not a response A debug message, the response to the specified query from an upstream nameserver was a CNAME that had mutiple RRs in the RRset. This is an invalid response according to the standards so a SERVFAIL will be returned to the system making the original query. % RESLIB_NOT_ONE_QNAME_RESPONSE not one question in response to query for <%1> A debug message, the response to the specified query from an upstream nameserver (as identified by the ID of the response) did not contain one name in the question section as required by the standard. A SERVFAIL will be returned to the system making the original query. % RESLIB_NOT_RESPONSE response to query for <%1> was not a response A debug message, the response to the specified query from an upstream nameserver (as identified by the ID of the response) did not have the QR bit set (thus indicating that the packet was a query, not a response). A SERVFAIL will be returned to the system making the original query. % RESLIB_NO_NS_RRSET no NS RRSet in referral response received to query for <%1> A debug message, this indicates that a response was received for the specified query and was categorized as a referral. However, the received message did not contain any NS RRsets. This may indicate a programming error in the response classification code. % RESLIB_NSAS_LOOKUP looking up nameserver for zone %1 in the NSAS A debug message, the RunningQuery object is querying the NSAS for the nameservers for the specified zone. % RESLIB_NXDOM_NXRR NXDOMAIN/NXRRSET received in response to query for <%1> A debug message recording that either a NXDOMAIN or an NXRRSET response has been received to an upstream query for the specified question. Previous debug messages will have indicated the server to which the question was sent. % RESLIB_OPCODE_RESPONSE response to query for <%1> did not have query opcode A debug message, the response to the specified query from an upstream nameserver was a response that did not have the opcode set to that of a query. According to the standards, this is an invalid response to the query that was made, so a SERVFAIL will be returned to the system making the original query. % RESLIB_PROTOCOL protocol error in answer for %1: %3 A debug message indicating that a protocol error was received. As there are no retries left, an error will be reported. % RESLIB_PROTOCOL_RETRY protocol error in answer for %1: %2 (retries left: %3) A debug message indicating that a protocol error was received and that the resolver is repeating the query to the same nameserver. After this repeated query, there will be the indicated number of retries left. % RESLIB_RCODE_ERROR response to query for <%1> returns RCODE of %2 A debug message, the response to the specified query indicated an error that is not covered by a specific code path. A SERVFAIL will be returned. % RESLIB_RECQ_CACHE_FIND found <%1> in the cache (resolve() instance %2) This is a debug message and indicates that a RecursiveQuery object found the the specified tuple in the cache. The instance number at the end of the message indicates which of the two resolve() methods has been called. % RESLIB_RECQ_CACHE_NO_FIND did not find <%1> in the cache, starting RunningQuery (resolve() instance %2) This is a debug message and indicates that the look in the cache made by the RecursiveQuery::resolve() method did not find an answer, so a new RunningQuery object has been created to resolve the question. The instance number at the end of the message indicates which of the two resolve() methods has been called. % RESLIB_REFERRAL referral received in response to query for <%1> A debug message recording that a referral response has been received to an upstream query for the specified question. Previous debug messages will have indicated the server to which the question was sent. % RESLIB_REFER_ZONE referred to zone %1 A debug message indicating that the last referral message was to the specified zone. % RESLIB_RESOLVE asked to resolve <%1> (resolve() instance %2) A debug message, the RecursiveQuery::resolve method has been called to resolve the specified tuple. The first action will be to lookup the specified tuple in the cache. The instance number at the end of the message indicates which of the two resolve() methods has been called. % RESLIB_RRSET_FOUND found single RRset in the cache when querying for <%1> (resolve() instance %2) A debug message, indicating that when RecursiveQuery::resolve queried the cache, a single RRset was found which was put in the answer. The instance number at the end of the message indicates which of the two resolve() methods has been called. % RESLIB_RTT round-trip time of last query calculated as %1 ms A debug message giving the round-trip time of the last query and response. % RESLIB_RUNQ_CACHE_FIND found <%1> in the cache This is a debug message and indicates that a RunningQuery object found the specified tuple in the cache. % RESLIB_RUNQ_CACHE_LOOKUP looking up up <%1> in the cache This is a debug message and indicates that a RunningQuery object has made a call to its doLookup() method to look up the specified tuple, the first action of which will be to examine the cache. % RESLIB_RUNQ_FAIL failure callback - nameservers are unreachable A debug message indicating that a RunningQuery's failure callback has been called because all nameservers for the zone in question are unreachable. % RESLIB_RUNQ_SUCCESS success callback - sending query to %1 A debug message indicating that a RunningQuery's success callback has been called because a nameserver has been found, and that a query is being sent to the specified nameserver. % RESLIB_TCP_TRUNCATED TCP response to query for %1 was truncated This is a debug message logged when a response to the specified query to an upstream nameserver returned a response with the TC (truncation) bit set. This is treated as an error by the code. % RESLIB_TEST_SERVER setting test server to %1(%2) This is a warning message only generated in unit tests. It indicates that all upstream queries from the resolver are being routed to the specified server, regardless of the address of the nameserver to which the query would normally be routed. If seen during normal operation, please submit a bug report. % RESLIB_TEST_UPSTREAM sending upstream query for <%1> to test server at %2 This is a debug message and should only be seen in unit tests. A query for the specified tuple is being sent to a test nameserver whose address is given in the message. % RESLIB_TIMEOUT query <%1> to %2 timed out A debug message indicating that the specified upstream query has timed out and there are no retries left. % RESLIB_TIMEOUT_RETRY query <%1> to %2 timed out, re-trying (retries left: %3) A debug message indicating that the specified query has timed out and that the resolver is repeating the query to the same nameserver. After this repeated query, there will be the indicated number of retries left. % RESLIB_TRUNCATED response to query for <%1> was truncated, re-querying over TCP A debug message, this indicates that the response to the specified query was truncated and that the resolver will be re-querying over TCP. There are various reasons why responses may be truncated, so this message is normal and gives no cause for concern. % RESLIB_UPSTREAM sending upstream query for <%1> to %2 A debug message indicating that a query for the specified tuple is being sent to a nameserver whose address is given in the message.