r71718 - in /trunk/libsocket-getaddrinfo-perl/debian: README.Debian changelog libsocket-getaddrinfo-perl.examples rules

[periapt-guest at users.alioth.debian.org]

Author: periapt-guest
Date: Sat Mar 19 23:12:27 2011
New Revision: 71718

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=71718
Log:
Review README.Debian and install ... (will close: #618315)

Removed:
    trunk/libsocket-getaddrinfo-perl/debian/libsocket-getaddrinfo-perl.examples
Modified:
    trunk/libsocket-getaddrinfo-perl/debian/README.Debian
    trunk/libsocket-getaddrinfo-perl/debian/changelog
    trunk/libsocket-getaddrinfo-perl/debian/rules

Modified: trunk/libsocket-getaddrinfo-perl/debian/README.Debian
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libsocket-getaddrinfo-perl/debian/README.Debian?rev=71718&op=diff
==============================================================================
--- trunk/libsocket-getaddrinfo-perl/debian/README.Debian (original)
+++ trunk/libsocket-getaddrinfo-perl/debian/README.Debian Sat Mar 19 23:12:27 2011
@@ -1,5 +1,46 @@
 Since version 0.20, upstream have distributed getnameinfo and getaddrinfo
-as scripts in the bin directory. Since the functionality of these 
-scripts is a subset of that provided by 'dig' and 'nslookup',
-we feel that these are better considered examples and have been installed
-as such. The utilities dig and nslookup can be found in the 'dnsutils' package.
+as scripts in the bin directory. Superficially the functionality of these
+scripts is a subset of that provided by 'dig' and 'nslookup'.
+However this is not really correct. 'dig' and 'nslookup' are both DNS clients;
+they directly talk DNS to diagnose DNS problems.
+
+The utility of these utilities, however, is that they provide a shell
+output showing _exactly_ what a normal userland binary would do to
+resolve hostnames into addresses or vice versa; INCLUDING the IPv4/IPv6
+ordering, or for example /etc/hosts. This ordering can be the subject of many
+subtle bugs in connections, either causing timeouts, delays, or outright
+failures. It is useful to have a commandline debug tool for getaddrinfo(3) in
+such scenarios. Neither 'dig' nor 'nslookup' can be of any help diagnosing
+these problems.
+
+In fact, case in point... The reason I was wanting to use getaddrinfo in
+the first place, was to debug why a server of mine was listening on
+[::1] rather than 127.0.0.1; the relevant output was:
+
+---
+
+$ getaddrinfo --passive --service 8034
+Resolved host '', service '8034'
+
+socket(AF_INET , SOCK_STREAM, IPPROTO_TCP) + '0.0.0.0:8034'
+socket(AF_INET , SOCK_DGRAM , IPPROTO_UDP) + '0.0.0.0:8034'
+socket(AF_INET , SOCK_RAW   , IPPROTO_IP ) + '0.0.0.0:8034'
+socket(AF_INET6, SOCK_STREAM, IPPROTO_TCP) + '[::]:8034'
+socket(AF_INET6, SOCK_DGRAM , IPPROTO_UDP) + '[::]:8034'
+socket(AF_INET6, SOCK_RAW   , IPPROTO_IP ) + '[::]:8034'
+
+$ getaddrinfo --service 8034
+Resolved host '', service '8034'
+
+socket(AF_INET6, SOCK_STREAM, IPPROTO_TCP) + '[::1]:8034'
+socket(AF_INET6, SOCK_DGRAM , IPPROTO_UDP) + '[::1]:8034'
+socket(AF_INET6, SOCK_RAW   , IPPROTO_IP ) + '[::1]:8034'
+socket(AF_INET , SOCK_STREAM, IPPROTO_TCP) + '127.0.0.1:8034'
+socket(AF_INET , SOCK_DGRAM , IPPROTO_UDP) + '127.0.0.1:8034'
+socket(AF_INET , SOCK_RAW   , IPPROTO_IP ) + '127.0.0.1:8034'
+
+---
+
+This sort of direct observation of glibc's behaviour is not possible
+using 'dig' or 'nslookup'.
+

Modified: trunk/libsocket-getaddrinfo-perl/debian/changelog
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libsocket-getaddrinfo-perl/debian/changelog?rev=71718&op=diff
==============================================================================
--- trunk/libsocket-getaddrinfo-perl/debian/changelog (original)
+++ trunk/libsocket-getaddrinfo-perl/debian/changelog Sat Mar 19 23:12:27 2011
@@ -1,3 +1,9 @@
+libsocket-getaddrinfo-perl (0.20-2) UNRELEASED; urgency=low
+
+  * Review README.Debian and install ... (will close: #618315)
+
+ -- Nicholas Bamber <nicholas at periapt.co.uk>  Sat, 19 Mar 2011 20:40:56 +0000
+
 libsocket-getaddrinfo-perl (0.20-1) unstable; urgency=low
 
   [ Ansgar Burchardt ]

Modified: trunk/libsocket-getaddrinfo-perl/debian/rules
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libsocket-getaddrinfo-perl/debian/rules?rev=71718&op=diff
==============================================================================
--- trunk/libsocket-getaddrinfo-perl/debian/rules (original)
+++ trunk/libsocket-getaddrinfo-perl/debian/rules Sat Mar 19 23:12:27 2011
@@ -6,15 +6,7 @@
 %:
 	dh $@
 
-override_dh_auto_install:
-	dh_auto_install
-	rm -rf $(TMP)/usr/bin
-	rm -rf $(TMP)/usr/share/man/man1
+#override_dh_auto_build:
+#	dh_installexamples
+#	chmod a+x $(TMP)/usr/share/doc/$(PKG)/examples/*
 
-override_dh_installexamples:
-	dh_installexamples
-	chmod a+x $(TMP)/usr/share/doc/$(PKG)/examples/*
-
-override_dh_compress:
-	dh_compress -Xexamples
-