Jonathan Nieder wrote: > Package: manpages-dev > Version: 3.27-1 > Severity: wishlist > Tags: upstream > > Martin Ferrari wrote[1]: > > > I'm using functions defined in arpa/nameser.h, undocumented in libc, but > > explained in chapter 12 of O'Reilly's DNS & BIND (ISBN: 0-596-00158-4). > > I do think that this lack of documentation is also a bug. > > He's right --- these functions are useful and a longstanding API, and > it is not very rare to find programs that use them. > > They became part of the libresolv ABI in glibc 2.9, which provides us > with a convenient list[2]: > > ns_msg_getflag > ns_get16, ns_get32, ns_put16, ns_put32 > ns_initparse, ns_skiprr, ns_parserr > ns_sprintrr, ns_sprintrrf > ns_format_ttl, ns_parse_ttl > ns_datetosecs > ns_name_ntol, ns_name_ntop, ns_name_pton > ns_name_unpack, ns_name_pack > ns_name_uncompress, ns_name_compress > ns_name_skip, ns_name_rollback > ns_samedomain, ns_subdomain, ns_makecanon, ns_samename
the only documentation i know of for some of these functions is in the DNS & BIND book starting around p. 447 (5th edition). it would probably be best if documentation for these functions were not readily available in order to discourage their use in new projects, as there are much better modern DNS message parsing libraries available. > The code comes from Bind 8.2.2-P5 originally. The BIND documentation > says[3]: > [3] http://ftp.isc.org/isc/bind9/cur/9.8/doc/arm/Bv9ARM.ch09.html#id2609111 the BIND9 9.8 documentation is totally irrelevant in this case, as BIND9 9.8 lacks the BIND4/BIND8 resolver library. the relevant ISC product would be libbind, but i don't believe those functions are documented in libbind either. (side note: i will probably request the removal of the libbind package from debian before the next stable release, now that glibc's libresolv has finally been fixed.) -- Robert Edmonds edmo...@debian.org -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org