xref: /freebsd/lib/libc/resolv/res_debug.c (revision 1e413cf93298b5b97441a21d9a50fdcd0ee9945e)
1 /*
2  * Copyright (c) 1985
3  *    The Regents of the University of California.  All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 4. Neither the name of the University nor the names of its contributors
14  *    may be used to endorse or promote products derived from this software
15  *    without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  */
29 
30 /*
31  * Portions Copyright (c) 1993 by Digital Equipment Corporation.
32  *
33  * Permission to use, copy, modify, and distribute this software for any
34  * purpose with or without fee is hereby granted, provided that the above
35  * copyright notice and this permission notice appear in all copies, and that
36  * the name of Digital Equipment Corporation not be used in advertising or
37  * publicity pertaining to distribution of the document or software without
38  * specific, written prior permission.
39  *
40  * THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL
41  * WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES
42  * OF MERCHANTABILITY AND FITNESS.   IN NO EVENT SHALL DIGITAL EQUIPMENT
43  * CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
44  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
45  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
46  * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
47  * SOFTWARE.
48  */
49 
50 /*
51  * Portions Copyright (c) 1995 by International Business Machines, Inc.
52  *
53  * International Business Machines, Inc. (hereinafter called IBM) grants
54  * permission under its copyrights to use, copy, modify, and distribute this
55  * Software with or without fee, provided that the above copyright notice and
56  * all paragraphs of this notice appear in all copies, and that the name of IBM
57  * not be used in connection with the marketing of any product incorporating
58  * the Software or modifications thereof, without specific, written prior
59  * permission.
60  *
61  * To the extent it has a right to do so, IBM grants an immunity from suit
62  * under its patents, if any, for the use, sale or manufacture of products to
63  * the extent that such products are used for performing Domain Name System
64  * dynamic updates in TCP/IP networks by means of the Software.  No immunity is
65  * granted for any product per se or for any other function of any product.
66  *
67  * THE SOFTWARE IS PROVIDED "AS IS", AND IBM DISCLAIMS ALL WARRANTIES,
68  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
69  * PARTICULAR PURPOSE.  IN NO EVENT SHALL IBM BE LIABLE FOR ANY SPECIAL,
70  * DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER ARISING
71  * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE, EVEN
72  * IF IBM IS APPRISED OF THE POSSIBILITY OF SUCH DAMAGES.
73  */
74 
75 /*
76  * Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC")
77  * Portions Copyright (c) 1996-1999 by Internet Software Consortium.
78  *
79  * Permission to use, copy, modify, and distribute this software for any
80  * purpose with or without fee is hereby granted, provided that the above
81  * copyright notice and this permission notice appear in all copies.
82  *
83  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
84  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
85  * MERCHANTABILITY AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR
86  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
87  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
88  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
89  * OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
90  */
91 
92 #if defined(LIBC_SCCS) && !defined(lint)
93 static const char sccsid[] = "@(#)res_debug.c	8.1 (Berkeley) 6/4/93";
94 static const char rcsid[] = "$Id: res_debug.c,v 1.10.18.5 2005/07/28 07:38:11 marka Exp $";
95 #endif /* LIBC_SCCS and not lint */
96 #include <sys/cdefs.h>
97 __FBSDID("$FreeBSD$");
98 
99 #include "port_before.h"
100 
101 #include <sys/types.h>
102 #include <sys/param.h>
103 #include <sys/socket.h>
104 
105 #include <netinet/in.h>
106 #include <arpa/inet.h>
107 #include <arpa/nameser.h>
108 
109 #include <ctype.h>
110 #include <errno.h>
111 #include <math.h>
112 #include <netdb.h>
113 #include <resolv.h>
114 #include <resolv_mt.h>
115 #include <stdio.h>
116 #include <stdlib.h>
117 #include <string.h>
118 #include <time.h>
119 
120 #include "port_after.h"
121 
122 #ifdef SPRINTF_CHAR
123 # define SPRINTF(x) strlen(sprintf/**/x)
124 #else
125 # define SPRINTF(x) sprintf x
126 #endif
127 
128 extern const char *_res_opcodes[];
129 extern const char *_res_sectioncodes[];
130 
131 /*%
132  * Print the current options.
133  */
134 void
135 fp_resstat(const res_state statp, FILE *file) {
136 	u_long mask;
137 
138 	fprintf(file, ";; res options:");
139 	for (mask = 1;  mask != 0U;  mask <<= 1)
140 		if (statp->options & mask)
141 			fprintf(file, " %s", p_option(mask));
142 	putc('\n', file);
143 }
144 
145 static void
146 do_section(const res_state statp,
147 	   ns_msg *handle, ns_sect section,
148 	   int pflag, FILE *file)
149 {
150 	int n, sflag, rrnum;
151 	static int buflen = 2048;
152 	char *buf;
153 	ns_opcode opcode;
154 	ns_rr rr;
155 
156 	/*
157 	 * Print answer records.
158 	 */
159 	sflag = (statp->pfcode & pflag);
160 	if (statp->pfcode && !sflag)
161 		return;
162 
163 	buf = malloc(buflen);
164 	if (buf == NULL) {
165 		fprintf(file, ";; memory allocation failure\n");
166 		return;
167 	}
168 
169 	opcode = (ns_opcode) ns_msg_getflag(*handle, ns_f_opcode);
170 	rrnum = 0;
171 	for (;;) {
172 		if (ns_parserr(handle, section, rrnum, &rr)) {
173 			if (errno != ENODEV)
174 				fprintf(file, ";; ns_parserr: %s\n",
175 					strerror(errno));
176 			else if (rrnum > 0 && sflag != 0 &&
177 				 (statp->pfcode & RES_PRF_HEAD1))
178 				putc('\n', file);
179 			goto cleanup;
180 		}
181 		if (rrnum == 0 && sflag != 0 && (statp->pfcode & RES_PRF_HEAD1))
182 			fprintf(file, ";; %s SECTION:\n",
183 				p_section(section, opcode));
184 		if (section == ns_s_qd)
185 			fprintf(file, ";;\t%s, type = %s, class = %s\n",
186 				ns_rr_name(rr),
187 				p_type(ns_rr_type(rr)),
188 				p_class(ns_rr_class(rr)));
189 		else if (section == ns_s_ar && ns_rr_type(rr) == ns_t_opt) {
190 			u_int32_t ttl = ns_rr_ttl(rr);
191 			fprintf(file,
192 				"; EDNS: version: %u, udp=%u, flags=%04x\n",
193 				(ttl>>16)&0xff, ns_rr_class(rr), ttl&0xffff);
194 		} else {
195 			n = ns_sprintrr(handle, &rr, NULL, NULL,
196 					buf, buflen);
197 			if (n < 0) {
198 				if (errno == ENOSPC) {
199 					free(buf);
200 					buf = NULL;
201 					if (buflen < 131072)
202 						buf = malloc(buflen += 1024);
203 					if (buf == NULL) {
204 						fprintf(file,
205 				              ";; memory allocation failure\n");
206 					      return;
207 					}
208 					continue;
209 				}
210 				fprintf(file, ";; ns_sprintrr: %s\n",
211 					strerror(errno));
212 				goto cleanup;
213 			}
214 			fputs(buf, file);
215 			fputc('\n', file);
216 		}
217 		rrnum++;
218 	}
219  cleanup:
220 	if (buf != NULL)
221 		free(buf);
222 }
223 
224 /*%
225  * Print the contents of a query.
226  * This is intended to be primarily a debugging routine.
227  */
228 void
229 res_pquery(const res_state statp, const u_char *msg, int len, FILE *file) {
230 	ns_msg handle;
231 	int qdcount, ancount, nscount, arcount;
232 	u_int opcode, rcode, id;
233 
234 	if (ns_initparse(msg, len, &handle) < 0) {
235 		fprintf(file, ";; ns_initparse: %s\n", strerror(errno));
236 		return;
237 	}
238 	opcode = ns_msg_getflag(handle, ns_f_opcode);
239 	rcode = ns_msg_getflag(handle, ns_f_rcode);
240 	id = ns_msg_id(handle);
241 	qdcount = ns_msg_count(handle, ns_s_qd);
242 	ancount = ns_msg_count(handle, ns_s_an);
243 	nscount = ns_msg_count(handle, ns_s_ns);
244 	arcount = ns_msg_count(handle, ns_s_ar);
245 
246 	/*
247 	 * Print header fields.
248 	 */
249 	if ((!statp->pfcode) || (statp->pfcode & RES_PRF_HEADX) || rcode)
250 		fprintf(file,
251 			";; ->>HEADER<<- opcode: %s, status: %s, id: %d\n",
252 			_res_opcodes[opcode], p_rcode(rcode), id);
253 	if ((!statp->pfcode) || (statp->pfcode & RES_PRF_HEADX))
254 		putc(';', file);
255 	if ((!statp->pfcode) || (statp->pfcode & RES_PRF_HEAD2)) {
256 		fprintf(file, "; flags:");
257 		if (ns_msg_getflag(handle, ns_f_qr))
258 			fprintf(file, " qr");
259 		if (ns_msg_getflag(handle, ns_f_aa))
260 			fprintf(file, " aa");
261 		if (ns_msg_getflag(handle, ns_f_tc))
262 			fprintf(file, " tc");
263 		if (ns_msg_getflag(handle, ns_f_rd))
264 			fprintf(file, " rd");
265 		if (ns_msg_getflag(handle, ns_f_ra))
266 			fprintf(file, " ra");
267 		if (ns_msg_getflag(handle, ns_f_z))
268 			fprintf(file, " ??");
269 		if (ns_msg_getflag(handle, ns_f_ad))
270 			fprintf(file, " ad");
271 		if (ns_msg_getflag(handle, ns_f_cd))
272 			fprintf(file, " cd");
273 	}
274 	if ((!statp->pfcode) || (statp->pfcode & RES_PRF_HEAD1)) {
275 		fprintf(file, "; %s: %d",
276 			p_section(ns_s_qd, opcode), qdcount);
277 		fprintf(file, ", %s: %d",
278 			p_section(ns_s_an, opcode), ancount);
279 		fprintf(file, ", %s: %d",
280 			p_section(ns_s_ns, opcode), nscount);
281 		fprintf(file, ", %s: %d",
282 			p_section(ns_s_ar, opcode), arcount);
283 	}
284 	if ((!statp->pfcode) || (statp->pfcode &
285 		(RES_PRF_HEADX | RES_PRF_HEAD2 | RES_PRF_HEAD1))) {
286 		putc('\n',file);
287 	}
288 	/*
289 	 * Print the various sections.
290 	 */
291 	do_section(statp, &handle, ns_s_qd, RES_PRF_QUES, file);
292 	do_section(statp, &handle, ns_s_an, RES_PRF_ANS, file);
293 	do_section(statp, &handle, ns_s_ns, RES_PRF_AUTH, file);
294 	do_section(statp, &handle, ns_s_ar, RES_PRF_ADD, file);
295 	if (qdcount == 0 && ancount == 0 &&
296 	    nscount == 0 && arcount == 0)
297 		putc('\n', file);
298 }
299 
300 const u_char *
301 p_cdnname(const u_char *cp, const u_char *msg, int len, FILE *file) {
302 	char name[MAXDNAME];
303 	int n;
304 
305 	if ((n = dn_expand(msg, msg + len, cp, name, sizeof name)) < 0)
306 		return (NULL);
307 	if (name[0] == '\0')
308 		putc('.', file);
309 	else
310 		fputs(name, file);
311 	return (cp + n);
312 }
313 
314 const u_char *
315 p_cdname(const u_char *cp, const u_char *msg, FILE *file) {
316 	return (p_cdnname(cp, msg, PACKETSZ, file));
317 }
318 
319 /*%
320  * Return a fully-qualified domain name from a compressed name (with
321    length supplied).  */
322 
323 const u_char *
324 p_fqnname(cp, msg, msglen, name, namelen)
325 	const u_char *cp, *msg;
326 	int msglen;
327 	char *name;
328 	int namelen;
329 {
330 	int n, newlen;
331 
332 	if ((n = dn_expand(msg, cp + msglen, cp, name, namelen)) < 0)
333 		return (NULL);
334 	newlen = strlen(name);
335 	if (newlen == 0 || name[newlen - 1] != '.') {
336 		if (newlen + 1 >= namelen)	/*%< Lack space for final dot */
337 			return (NULL);
338 		else
339 			strcpy(name + newlen, ".");
340 	}
341 	return (cp + n);
342 }
343 
344 /* XXX:	the rest of these functions need to become length-limited, too. */
345 
346 const u_char *
347 p_fqname(const u_char *cp, const u_char *msg, FILE *file) {
348 	char name[MAXDNAME];
349 	const u_char *n;
350 
351 	n = p_fqnname(cp, msg, MAXCDNAME, name, sizeof name);
352 	if (n == NULL)
353 		return (NULL);
354 	fputs(name, file);
355 	return (n);
356 }
357 
358 /*%
359  * Names of RR classes and qclasses.  Classes and qclasses are the same, except
360  * that C_ANY is a qclass but not a class.  (You can ask for records of class
361  * C_ANY, but you can't have any records of that class in the database.)
362  */
363 const struct res_sym __p_class_syms[] = {
364 	{C_IN,		"IN",		(char *)0},
365 	{C_CHAOS,	"CH",		(char *)0},
366 	{C_CHAOS,	"CHAOS",	(char *)0},
367 	{C_HS,		"HS",		(char *)0},
368 	{C_HS,		"HESIOD",	(char *)0},
369 	{C_ANY,		"ANY",		(char *)0},
370 	{C_NONE,	"NONE",		(char *)0},
371 	{C_IN, 		(char *)0,	(char *)0}
372 };
373 
374 /*%
375  * Names of message sections.
376  */
377 static const struct res_sym __p_default_section_syms[] = {
378 	{ns_s_qd,	"QUERY",	(char *)0},
379 	{ns_s_an,	"ANSWER",	(char *)0},
380 	{ns_s_ns,	"AUTHORITY",	(char *)0},
381 	{ns_s_ar,	"ADDITIONAL",	(char *)0},
382 	{0,             (char *)0,	(char *)0}
383 };
384 
385 static const struct res_sym __p_update_section_syms[] = {
386 	{S_ZONE,	"ZONE",		(char *)0},
387 	{S_PREREQ,	"PREREQUISITE",	(char *)0},
388 	{S_UPDATE,	"UPDATE",	(char *)0},
389 	{S_ADDT,	"ADDITIONAL",	(char *)0},
390 	{0,             (char *)0,	(char *)0}
391 };
392 
393 const struct res_sym __p_key_syms[] = {
394 	{NS_ALG_MD5RSA,		"RSA",		"RSA KEY with MD5 hash"},
395 	{NS_ALG_DH,		"DH",		"Diffie Hellman"},
396 	{NS_ALG_DSA,		"DSA",		"Digital Signature Algorithm"},
397 	{NS_ALG_EXPIRE_ONLY,	"EXPIREONLY",	"No algorithm"},
398 	{NS_ALG_PRIVATE_OID,	"PRIVATE",	"Algorithm obtained from OID"},
399 	{0,			NULL,		NULL}
400 };
401 
402 const struct res_sym __p_cert_syms[] = {
403 	{cert_t_pkix,	"PKIX",		"PKIX (X.509v3) Certificate"},
404 	{cert_t_spki,	"SPKI",		"SPKI certificate"},
405 	{cert_t_pgp,	"PGP",		"PGP certificate"},
406 	{cert_t_url,	"URL",		"URL Private"},
407 	{cert_t_oid,	"OID",		"OID Private"},
408 	{0,		NULL,		NULL}
409 };
410 
411 /*%
412  * Names of RR types and qtypes.  Types and qtypes are the same, except
413  * that T_ANY is a qtype but not a type.  (You can ask for records of type
414  * T_ANY, but you can't have any records of that type in the database.)
415  */
416 const struct res_sym __p_type_syms[] = {
417 	{ns_t_a,	"A",		"address"},
418 	{ns_t_ns,	"NS",		"name server"},
419 	{ns_t_md,	"MD",		"mail destination (deprecated)"},
420 	{ns_t_mf,	"MF",		"mail forwarder (deprecated)"},
421 	{ns_t_cname,	"CNAME",	"canonical name"},
422 	{ns_t_soa,	"SOA",		"start of authority"},
423 	{ns_t_mb,	"MB",		"mailbox"},
424 	{ns_t_mg,	"MG",		"mail group member"},
425 	{ns_t_mr,	"MR",		"mail rename"},
426 	{ns_t_null,	"NULL",		"null"},
427 	{ns_t_wks,	"WKS",		"well-known service (deprecated)"},
428 	{ns_t_ptr,	"PTR",		"domain name pointer"},
429 	{ns_t_hinfo,	"HINFO",	"host information"},
430 	{ns_t_minfo,	"MINFO",	"mailbox information"},
431 	{ns_t_mx,	"MX",		"mail exchanger"},
432 	{ns_t_txt,	"TXT",		"text"},
433 	{ns_t_rp,	"RP",		"responsible person"},
434 	{ns_t_afsdb,	"AFSDB",	"DCE or AFS server"},
435 	{ns_t_x25,	"X25",		"X25 address"},
436 	{ns_t_isdn,	"ISDN",		"ISDN address"},
437 	{ns_t_rt,	"RT",		"router"},
438 	{ns_t_nsap,	"NSAP",		"nsap address"},
439 	{ns_t_nsap_ptr,	"NSAP_PTR",	"domain name pointer"},
440 	{ns_t_sig,	"SIG",		"signature"},
441 	{ns_t_key,	"KEY",		"key"},
442 	{ns_t_px,	"PX",		"mapping information"},
443 	{ns_t_gpos,	"GPOS",		"geographical position (withdrawn)"},
444 	{ns_t_aaaa,	"AAAA",		"IPv6 address"},
445 	{ns_t_loc,	"LOC",		"location"},
446 	{ns_t_nxt,	"NXT",		"next valid name (unimplemented)"},
447 	{ns_t_eid,	"EID",		"endpoint identifier (unimplemented)"},
448 	{ns_t_nimloc,	"NIMLOC",	"NIMROD locator (unimplemented)"},
449 	{ns_t_srv,	"SRV",		"server selection"},
450 	{ns_t_atma,	"ATMA",		"ATM address (unimplemented)"},
451 	{ns_t_tkey,	"TKEY",		"tkey"},
452 	{ns_t_tsig,	"TSIG",		"transaction signature"},
453 	{ns_t_ixfr,	"IXFR",		"incremental zone transfer"},
454 	{ns_t_axfr,	"AXFR",		"zone transfer"},
455 	{ns_t_zxfr,	"ZXFR",		"compressed zone transfer"},
456 	{ns_t_mailb,	"MAILB",	"mailbox-related data (deprecated)"},
457 	{ns_t_maila,	"MAILA",	"mail agent (deprecated)"},
458 	{ns_t_naptr,	"NAPTR",	"URN Naming Authority"},
459 	{ns_t_kx,	"KX",		"Key Exchange"},
460 	{ns_t_cert,	"CERT",		"Certificate"},
461 	{ns_t_a6,	"A6",		"IPv6 Address"},
462 	{ns_t_dname,	"DNAME",	"dname"},
463 	{ns_t_sink,	"SINK",		"Kitchen Sink (experimental)"},
464 	{ns_t_opt,	"OPT",		"EDNS Options"},
465 	{ns_t_any,	"ANY",		"\"any\""},
466 	{0, 		NULL,		NULL}
467 };
468 
469 /*%
470  * Names of DNS rcodes.
471  */
472 const struct res_sym __p_rcode_syms[] = {
473 	{ns_r_noerror,	"NOERROR",		"no error"},
474 	{ns_r_formerr,	"FORMERR",		"format error"},
475 	{ns_r_servfail,	"SERVFAIL",		"server failed"},
476 	{ns_r_nxdomain,	"NXDOMAIN",		"no such domain name"},
477 	{ns_r_notimpl,	"NOTIMP",		"not implemented"},
478 	{ns_r_refused,	"REFUSED",		"refused"},
479 	{ns_r_yxdomain,	"YXDOMAIN",		"domain name exists"},
480 	{ns_r_yxrrset,	"YXRRSET",		"rrset exists"},
481 	{ns_r_nxrrset,	"NXRRSET",		"rrset doesn't exist"},
482 	{ns_r_notauth,	"NOTAUTH",		"not authoritative"},
483 	{ns_r_notzone,	"NOTZONE",		"Not in zone"},
484 	{ns_r_max,	"",			""},
485 	{ns_r_badsig,	"BADSIG",		"bad signature"},
486 	{ns_r_badkey,	"BADKEY",		"bad key"},
487 	{ns_r_badtime,	"BADTIME",		"bad time"},
488 	{0, 		NULL,			NULL}
489 };
490 
491 int
492 sym_ston(const struct res_sym *syms, const char *name, int *success) {
493 	for ((void)NULL; syms->name != 0; syms++) {
494 		if (strcasecmp (name, syms->name) == 0) {
495 			if (success)
496 				*success = 1;
497 			return (syms->number);
498 		}
499 	}
500 	if (success)
501 		*success = 0;
502 	return (syms->number);		/*%< The default value. */
503 }
504 
505 const char *
506 sym_ntos(const struct res_sym *syms, int number, int *success) {
507 	char *unname = sym_ntos_unname;
508 
509 	for ((void)NULL; syms->name != 0; syms++) {
510 		if (number == syms->number) {
511 			if (success)
512 				*success = 1;
513 			return (syms->name);
514 		}
515 	}
516 
517 	sprintf(unname, "%d", number);		/*%< XXX nonreentrant */
518 	if (success)
519 		*success = 0;
520 	return (unname);
521 }
522 
523 const char *
524 sym_ntop(const struct res_sym *syms, int number, int *success) {
525 	char *unname = sym_ntop_unname;
526 
527 	for ((void)NULL; syms->name != 0; syms++) {
528 		if (number == syms->number) {
529 			if (success)
530 				*success = 1;
531 			return (syms->humanname);
532 		}
533 	}
534 	sprintf(unname, "%d", number);		/*%< XXX nonreentrant */
535 	if (success)
536 		*success = 0;
537 	return (unname);
538 }
539 
540 /*%
541  * Return a string for the type.
542  */
543 const char *
544 p_type(int type) {
545 	int success;
546 	const char *result;
547 	static char typebuf[20];
548 
549 	result = sym_ntos(__p_type_syms, type, &success);
550 	if (success)
551 		return (result);
552 	if (type < 0 || type > 0xffff)
553 		return ("BADTYPE");
554 	sprintf(typebuf, "TYPE%d", type);
555 	return (typebuf);
556 }
557 
558 /*%
559  * Return a string for the type.
560  */
561 const char *
562 p_section(int section, int opcode) {
563 	const struct res_sym *symbols;
564 
565 	switch (opcode) {
566 	case ns_o_update:
567 		symbols = __p_update_section_syms;
568 		break;
569 	default:
570 		symbols = __p_default_section_syms;
571 		break;
572 	}
573 	return (sym_ntos(symbols, section, (int *)0));
574 }
575 
576 /*%
577  * Return a mnemonic for class.
578  */
579 const char *
580 p_class(int class) {
581 	int success;
582 	const char *result;
583 	static char classbuf[20];
584 
585 	result = sym_ntos(__p_class_syms, class, &success);
586 	if (success)
587 		return (result);
588 	if (class < 0 || class > 0xffff)
589 		return ("BADCLASS");
590 	sprintf(classbuf, "CLASS%d", class);
591 	return (classbuf);
592 }
593 
594 /*%
595  * Return a mnemonic for an option
596  */
597 const char *
598 p_option(u_long option) {
599 	char *nbuf = p_option_nbuf;
600 
601 	switch (option) {
602 	case RES_INIT:		return "init";
603 	case RES_DEBUG:		return "debug";
604 	case RES_AAONLY:	return "aaonly(unimpl)";
605 	case RES_USEVC:		return "usevc";
606 	case RES_PRIMARY:	return "primry(unimpl)";
607 	case RES_IGNTC:		return "igntc";
608 	case RES_RECURSE:	return "recurs";
609 	case RES_DEFNAMES:	return "defnam";
610 	case RES_STAYOPEN:	return "styopn";
611 	case RES_DNSRCH:	return "dnsrch";
612 	case RES_INSECURE1:	return "insecure1";
613 	case RES_INSECURE2:	return "insecure2";
614 	case RES_NOALIASES:	return "noaliases";
615 	case RES_USE_INET6:	return "inet6";
616 #ifdef RES_USE_EDNS0	/*%< KAME extension */
617 	case RES_USE_EDNS0:	return "edns0";
618 #endif
619 #ifdef RES_USE_DNAME
620 	case RES_USE_DNAME:	return "dname";
621 #endif
622 #ifdef RES_USE_DNSSEC
623 	case RES_USE_DNSSEC:	return "dnssec";
624 #endif
625 #ifdef RES_NOTLDQUERY
626 	case RES_NOTLDQUERY:	return "no-tld-query";
627 #endif
628 #ifdef RES_NO_NIBBLE2
629 	case RES_NO_NIBBLE2:	return "no-nibble2";
630 #endif
631 				/* XXX nonreentrant */
632 	default:		sprintf(nbuf, "?0x%lx?", (u_long)option);
633 				return (nbuf);
634 	}
635 }
636 
637 /*%
638  * Return a mnemonic for a time to live.
639  */
640 const char *
641 p_time(u_int32_t value) {
642 	char *nbuf = p_time_nbuf;
643 
644 	if (ns_format_ttl(value, nbuf, sizeof nbuf) < 0)
645 		sprintf(nbuf, "%u", value);
646 	return (nbuf);
647 }
648 
649 /*%
650  * Return a string for the rcode.
651  */
652 const char *
653 p_rcode(int rcode) {
654 	return (sym_ntos(__p_rcode_syms, rcode, (int *)0));
655 }
656 
657 /*%
658  * Return a string for a res_sockaddr_union.
659  */
660 const char *
661 p_sockun(union res_sockaddr_union u, char *buf, size_t size) {
662 	char ret[sizeof "ffff:ffff:ffff:ffff:ffff:ffff:123.123.123.123"];
663 
664 	switch (u.sin.sin_family) {
665 	case AF_INET:
666 		inet_ntop(AF_INET, &u.sin.sin_addr, ret, sizeof ret);
667 		break;
668 #ifdef HAS_INET6_STRUCTS
669 	case AF_INET6:
670 		inet_ntop(AF_INET6, &u.sin6.sin6_addr, ret, sizeof ret);
671 		break;
672 #endif
673 	default:
674 		sprintf(ret, "[af%d]", u.sin.sin_family);
675 		break;
676 	}
677 	if (size > 0U) {
678 		strncpy(buf, ret, size - 1);
679 		buf[size - 1] = '0';
680 	}
681 	return (buf);
682 }
683 
684 /*%
685  * routines to convert between on-the-wire RR format and zone file format.
686  * Does not contain conversion to/from decimal degrees; divide or multiply
687  * by 60*60*1000 for that.
688  */
689 
690 static unsigned int poweroften[10] = {1, 10, 100, 1000, 10000, 100000,
691 				      1000000,10000000,100000000,1000000000};
692 
693 /*% takes an XeY precision/size value, returns a string representation. */
694 static const char *
695 precsize_ntoa(prec)
696 	u_int8_t prec;
697 {
698 	char *retbuf = precsize_ntoa_retbuf;
699 	unsigned long val;
700 	int mantissa, exponent;
701 
702 	mantissa = (int)((prec >> 4) & 0x0f) % 10;
703 	exponent = (int)((prec >> 0) & 0x0f) % 10;
704 
705 	val = mantissa * poweroften[exponent];
706 
707 	(void) sprintf(retbuf, "%lu.%.2lu", val/100, val%100);
708 	return (retbuf);
709 }
710 
711 /*% converts ascii size/precision X * 10**Y(cm) to 0xXY.  moves pointer.  */
712 static u_int8_t
713 precsize_aton(const char **strptr) {
714 	unsigned int mval = 0, cmval = 0;
715 	u_int8_t retval = 0;
716 	const char *cp;
717 	int exponent;
718 	int mantissa;
719 
720 	cp = *strptr;
721 
722 	while (isdigit((unsigned char)*cp))
723 		mval = mval * 10 + (*cp++ - '0');
724 
725 	if (*cp == '.') {		/*%< centimeters */
726 		cp++;
727 		if (isdigit((unsigned char)*cp)) {
728 			cmval = (*cp++ - '0') * 10;
729 			if (isdigit((unsigned char)*cp)) {
730 				cmval += (*cp++ - '0');
731 			}
732 		}
733 	}
734 	cmval = (mval * 100) + cmval;
735 
736 	for (exponent = 0; exponent < 9; exponent++)
737 		if (cmval < poweroften[exponent+1])
738 			break;
739 
740 	mantissa = cmval / poweroften[exponent];
741 	if (mantissa > 9)
742 		mantissa = 9;
743 
744 	retval = (mantissa << 4) | exponent;
745 
746 	*strptr = cp;
747 
748 	return (retval);
749 }
750 
751 /*% converts ascii lat/lon to unsigned encoded 32-bit number.  moves pointer. */
752 static u_int32_t
753 latlon2ul(const char **latlonstrptr, int *which) {
754 	const char *cp;
755 	u_int32_t retval;
756 	int deg = 0, min = 0, secs = 0, secsfrac = 0;
757 
758 	cp = *latlonstrptr;
759 
760 	while (isdigit((unsigned char)*cp))
761 		deg = deg * 10 + (*cp++ - '0');
762 
763 	while (isspace((unsigned char)*cp))
764 		cp++;
765 
766 	if (!(isdigit((unsigned char)*cp)))
767 		goto fndhemi;
768 
769 	while (isdigit((unsigned char)*cp))
770 		min = min * 10 + (*cp++ - '0');
771 
772 	while (isspace((unsigned char)*cp))
773 		cp++;
774 
775 	if (!(isdigit((unsigned char)*cp)))
776 		goto fndhemi;
777 
778 	while (isdigit((unsigned char)*cp))
779 		secs = secs * 10 + (*cp++ - '0');
780 
781 	if (*cp == '.') {		/*%< decimal seconds */
782 		cp++;
783 		if (isdigit((unsigned char)*cp)) {
784 			secsfrac = (*cp++ - '0') * 100;
785 			if (isdigit((unsigned char)*cp)) {
786 				secsfrac += (*cp++ - '0') * 10;
787 				if (isdigit((unsigned char)*cp)) {
788 					secsfrac += (*cp++ - '0');
789 				}
790 			}
791 		}
792 	}
793 
794 	while (!isspace((unsigned char)*cp))	/*%< if any trailing garbage */
795 		cp++;
796 
797 	while (isspace((unsigned char)*cp))
798 		cp++;
799 
800  fndhemi:
801 	switch (*cp) {
802 	case 'N': case 'n':
803 	case 'E': case 'e':
804 		retval = ((unsigned)1<<31)
805 			+ (((((deg * 60) + min) * 60) + secs) * 1000)
806 			+ secsfrac;
807 		break;
808 	case 'S': case 's':
809 	case 'W': case 'w':
810 		retval = ((unsigned)1<<31)
811 			- (((((deg * 60) + min) * 60) + secs) * 1000)
812 			- secsfrac;
813 		break;
814 	default:
815 		retval = 0;	/*%< invalid value -- indicates error */
816 		break;
817 	}
818 
819 	switch (*cp) {
820 	case 'N': case 'n':
821 	case 'S': case 's':
822 		*which = 1;	/*%< latitude */
823 		break;
824 	case 'E': case 'e':
825 	case 'W': case 'w':
826 		*which = 2;	/*%< longitude */
827 		break;
828 	default:
829 		*which = 0;	/*%< error */
830 		break;
831 	}
832 
833 	cp++;			/*%< skip the hemisphere */
834 	while (!isspace((unsigned char)*cp))	/*%< if any trailing garbage */
835 		cp++;
836 
837 	while (isspace((unsigned char)*cp))	/*%< move to next field */
838 		cp++;
839 
840 	*latlonstrptr = cp;
841 
842 	return (retval);
843 }
844 
845 /*%
846  * converts a zone file representation in a string to an RDATA on-the-wire
847  * representation. */
848 int
849 loc_aton(ascii, binary)
850 	const char *ascii;
851 	u_char *binary;
852 {
853 	const char *cp, *maxcp;
854 	u_char *bcp;
855 
856 	u_int32_t latit = 0, longit = 0, alt = 0;
857 	u_int32_t lltemp1 = 0, lltemp2 = 0;
858 	int altmeters = 0, altfrac = 0, altsign = 1;
859 	u_int8_t hp = 0x16;	/*%< default = 1e6 cm = 10000.00m = 10km */
860 	u_int8_t vp = 0x13;	/*%< default = 1e3 cm = 10.00m */
861 	u_int8_t siz = 0x12;	/*%< default = 1e2 cm = 1.00m */
862 	int which1 = 0, which2 = 0;
863 
864 	cp = ascii;
865 	maxcp = cp + strlen(ascii);
866 
867 	lltemp1 = latlon2ul(&cp, &which1);
868 
869 	lltemp2 = latlon2ul(&cp, &which2);
870 
871 	switch (which1 + which2) {
872 	case 3:			/*%< 1 + 2, the only valid combination */
873 		if ((which1 == 1) && (which2 == 2)) { /*%< normal case */
874 			latit = lltemp1;
875 			longit = lltemp2;
876 		} else if ((which1 == 2) && (which2 == 1)) { /*%< reversed */
877 			longit = lltemp1;
878 			latit = lltemp2;
879 		} else {	/*%< some kind of brokenness */
880 			return (0);
881 		}
882 		break;
883 	default:		/*%< we didn't get one of each */
884 		return (0);
885 	}
886 
887 	/* altitude */
888 	if (*cp == '-') {
889 		altsign = -1;
890 		cp++;
891 	}
892 
893 	if (*cp == '+')
894 		cp++;
895 
896 	while (isdigit((unsigned char)*cp))
897 		altmeters = altmeters * 10 + (*cp++ - '0');
898 
899 	if (*cp == '.') {		/*%< decimal meters */
900 		cp++;
901 		if (isdigit((unsigned char)*cp)) {
902 			altfrac = (*cp++ - '0') * 10;
903 			if (isdigit((unsigned char)*cp)) {
904 				altfrac += (*cp++ - '0');
905 			}
906 		}
907 	}
908 
909 	alt = (10000000 + (altsign * (altmeters * 100 + altfrac)));
910 
911 	while (!isspace((unsigned char)*cp) && (cp < maxcp)) /*%< if trailing garbage or m */
912 		cp++;
913 
914 	while (isspace((unsigned char)*cp) && (cp < maxcp))
915 		cp++;
916 
917 	if (cp >= maxcp)
918 		goto defaults;
919 
920 	siz = precsize_aton(&cp);
921 
922 	while (!isspace((unsigned char)*cp) && (cp < maxcp))	/*%< if trailing garbage or m */
923 		cp++;
924 
925 	while (isspace((unsigned char)*cp) && (cp < maxcp))
926 		cp++;
927 
928 	if (cp >= maxcp)
929 		goto defaults;
930 
931 	hp = precsize_aton(&cp);
932 
933 	while (!isspace((unsigned char)*cp) && (cp < maxcp))	/*%< if trailing garbage or m */
934 		cp++;
935 
936 	while (isspace((unsigned char)*cp) && (cp < maxcp))
937 		cp++;
938 
939 	if (cp >= maxcp)
940 		goto defaults;
941 
942 	vp = precsize_aton(&cp);
943 
944  defaults:
945 
946 	bcp = binary;
947 	*bcp++ = (u_int8_t) 0;	/*%< version byte */
948 	*bcp++ = siz;
949 	*bcp++ = hp;
950 	*bcp++ = vp;
951 	PUTLONG(latit,bcp);
952 	PUTLONG(longit,bcp);
953 	PUTLONG(alt,bcp);
954 
955 	return (16);		/*%< size of RR in octets */
956 }
957 
958 /*% takes an on-the-wire LOC RR and formats it in a human readable format. */
959 const char *
960 loc_ntoa(binary, ascii)
961 	const u_char *binary;
962 	char *ascii;
963 {
964 	static const char *error = "?";
965 	static char tmpbuf[sizeof
966 "1000 60 60.000 N 1000 60 60.000 W -12345678.00m 90000000.00m 90000000.00m 90000000.00m"];
967 	const u_char *cp = binary;
968 
969 	int latdeg, latmin, latsec, latsecfrac;
970 	int longdeg, longmin, longsec, longsecfrac;
971 	char northsouth, eastwest;
972 	const char *altsign;
973 	int altmeters, altfrac;
974 
975 	const u_int32_t referencealt = 100000 * 100;
976 
977 	int32_t latval, longval, altval;
978 	u_int32_t templ;
979 	u_int8_t sizeval, hpval, vpval, versionval;
980 
981 	char *sizestr, *hpstr, *vpstr;
982 
983 	versionval = *cp++;
984 
985 	if (ascii == NULL)
986 		ascii = tmpbuf;
987 
988 	if (versionval) {
989 		(void) sprintf(ascii, "; error: unknown LOC RR version");
990 		return (ascii);
991 	}
992 
993 	sizeval = *cp++;
994 
995 	hpval = *cp++;
996 	vpval = *cp++;
997 
998 	GETLONG(templ, cp);
999 	latval = (templ - ((unsigned)1<<31));
1000 
1001 	GETLONG(templ, cp);
1002 	longval = (templ - ((unsigned)1<<31));
1003 
1004 	GETLONG(templ, cp);
1005 	if (templ < referencealt) { /*%< below WGS 84 spheroid */
1006 		altval = referencealt - templ;
1007 		altsign = "-";
1008 	} else {
1009 		altval = templ - referencealt;
1010 		altsign = "";
1011 	}
1012 
1013 	if (latval < 0) {
1014 		northsouth = 'S';
1015 		latval = -latval;
1016 	} else
1017 		northsouth = 'N';
1018 
1019 	latsecfrac = latval % 1000;
1020 	latval = latval / 1000;
1021 	latsec = latval % 60;
1022 	latval = latval / 60;
1023 	latmin = latval % 60;
1024 	latval = latval / 60;
1025 	latdeg = latval;
1026 
1027 	if (longval < 0) {
1028 		eastwest = 'W';
1029 		longval = -longval;
1030 	} else
1031 		eastwest = 'E';
1032 
1033 	longsecfrac = longval % 1000;
1034 	longval = longval / 1000;
1035 	longsec = longval % 60;
1036 	longval = longval / 60;
1037 	longmin = longval % 60;
1038 	longval = longval / 60;
1039 	longdeg = longval;
1040 
1041 	altfrac = altval % 100;
1042 	altmeters = (altval / 100);
1043 
1044 	sizestr = strdup(precsize_ntoa(sizeval));
1045 	hpstr = strdup(precsize_ntoa(hpval));
1046 	vpstr = strdup(precsize_ntoa(vpval));
1047 
1048 	sprintf(ascii,
1049 	    "%d %.2d %.2d.%.3d %c %d %.2d %.2d.%.3d %c %s%d.%.2dm %sm %sm %sm",
1050 		latdeg, latmin, latsec, latsecfrac, northsouth,
1051 		longdeg, longmin, longsec, longsecfrac, eastwest,
1052 		altsign, altmeters, altfrac,
1053 		(sizestr != NULL) ? sizestr : error,
1054 		(hpstr != NULL) ? hpstr : error,
1055 		(vpstr != NULL) ? vpstr : error);
1056 
1057 	if (sizestr != NULL)
1058 		free(sizestr);
1059 	if (hpstr != NULL)
1060 		free(hpstr);
1061 	if (vpstr != NULL)
1062 		free(vpstr);
1063 
1064 	return (ascii);
1065 }
1066 
1067 
1068 /*% Return the number of DNS hierarchy levels in the name. */
1069 int
1070 dn_count_labels(const char *name) {
1071 	int i, len, count;
1072 
1073 	len = strlen(name);
1074 	for (i = 0, count = 0; i < len; i++) {
1075 		/* XXX need to check for \. or use named's nlabels(). */
1076 		if (name[i] == '.')
1077 			count++;
1078 	}
1079 
1080 	/* don't count initial wildcard */
1081 	if (name[0] == '*')
1082 		if (count)
1083 			count--;
1084 
1085 	/* don't count the null label for root. */
1086 	/* if terminating '.' not found, must adjust */
1087 	/* count to include last label */
1088 	if (len > 0 && name[len-1] != '.')
1089 		count++;
1090 	return (count);
1091 }
1092 
1093 /*%
1094  * Make dates expressed in seconds-since-Jan-1-1970 easy to read.
1095  * SIG records are required to be printed like this, by the Secure DNS RFC.
1096  */
1097 char *
1098 p_secstodate (u_long secs) {
1099 	char *output = p_secstodate_output;
1100 	time_t clock = secs;
1101 	struct tm *time;
1102 #ifdef HAVE_TIME_R
1103 	struct tm res;
1104 
1105 	time = gmtime_r(&clock, &res);
1106 #else
1107 	time = gmtime(&clock);
1108 #endif
1109 	time->tm_year += 1900;
1110 	time->tm_mon += 1;
1111 	sprintf(output, "%04d%02d%02d%02d%02d%02d",
1112 		time->tm_year, time->tm_mon, time->tm_mday,
1113 		time->tm_hour, time->tm_min, time->tm_sec);
1114 	return (output);
1115 }
1116 
1117 u_int16_t
1118 res_nametoclass(const char *buf, int *successp) {
1119 	unsigned long result;
1120 	char *endptr;
1121 	int success;
1122 
1123 	result = sym_ston(__p_class_syms, buf, &success);
1124 	if (success)
1125 		goto done;
1126 
1127 	if (strncasecmp(buf, "CLASS", 5) != 0 ||
1128 	    !isdigit((unsigned char)buf[5]))
1129 		goto done;
1130 	errno = 0;
1131 	result = strtoul(buf + 5, &endptr, 10);
1132 	if (errno == 0 && *endptr == '\0' && result <= 0xffffU)
1133 		success = 1;
1134  done:
1135 	if (successp)
1136 		*successp = success;
1137 	return (result);
1138 }
1139 
1140 u_int16_t
1141 res_nametotype(const char *buf, int *successp) {
1142 	unsigned long result;
1143 	char *endptr;
1144 	int success;
1145 
1146 	result = sym_ston(__p_type_syms, buf, &success);
1147 	if (success)
1148 		goto done;
1149 
1150 	if (strncasecmp(buf, "type", 4) != 0 ||
1151 	    !isdigit((unsigned char)buf[4]))
1152 		goto done;
1153 	errno = 0;
1154 	result = strtoul(buf + 4, &endptr, 10);
1155 	if (errno == 0 && *endptr == '\0' && result <= 0xffffU)
1156 		success = 1;
1157  done:
1158 	if (successp)
1159 		*successp = success;
1160 	return (result);
1161 }
1162 
1163 /*
1164  * Weak aliases for applications that use certain private entry points,
1165  * and fail to include <resolv.h>.
1166  */
1167 #undef fp_resstat
1168 __weak_reference(__fp_resstat, fp_resstat);
1169 #undef p_fqnname
1170 __weak_reference(__p_fqnname, p_fqnname);
1171 #undef sym_ston
1172 __weak_reference(__sym_ston, sym_ston);
1173 #undef sym_ntos
1174 __weak_reference(__sym_ntos, sym_ntos);
1175 #undef sym_ntop
1176 __weak_reference(__sym_ntop, sym_ntop);
1177 #undef dn_count_labels
1178 __weak_reference(__dn_count_labels, dn_count_labels);
1179 #undef p_secstodate
1180 __weak_reference(__p_secstodate, p_secstodate);
1181 
1182 /*! \file */
1183