Your message dated Mon, 24 Jul 2006 15:32:14 -0700
with message-id <[EMAIL PROTECTED]>
and subject line Bug#307694: fixed in debian-goodies 0.24
has caused the attached Bug report to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere. Please contact me immediately.)
Debian bug tracking system administrator
(administrator, Debian Bugs database)
--- Begin Message ---
Package: debian-goodies
Version: N/A
Priority: wishlist
Tags: patch
I recently coded a network testing script that implements some of the tasks
commonly associated to testing network connectivity, since my intention is
to have this be useful for other users and not rot in my HD I'm attaching
it to this bug report in case you find this useful for the debian-goodies
package. If so, I will add a proper manpage for the script :-)
Regards
Javier
#!/bin/sh
# Network testing script v 1.2
# (c) 2005 Javier Fernandez-Sanguino
#
# This script will test your system's network configuration using basic
# tests and providing both information (INFO messages), warnings (WARN)
# and possible errors (ERR messages) by checking:
# - Interface status
# - Availability of configured routers, including the default route
# - Proper host resolution, including DNS checks
# - Proper network connectivity, including ICMP and web connections to
# a remote web server (the web server used for the tests can be configured,
# see below)
#
# Some of the network tests are described in more detail at
# http://ubuntuforums.org/archive/index.php/t-25557.html
#
# The script does not need special privileges to run as it does not
# do any system change. It also will not fix the errors by itself.
#
# Additional software requirements:
# * ip from the iproute package. (could probably be rewrittent to
# use ifconfig only or to parse /proc)
# * ping from the iputils-ping package or the netkit-ping package.
# * nc from the netcat package.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
#
# You can also find a copy of the GNU General Public License at
# http://www.gnu.org/licenses/licenses.html#TOCLGPL
#
# TODO
# - Works only on Linux, can this be generalised for other UNIX systems
# (probably not unless rewritten in C)
# - Does not check for errors properly, use -e and test intensively
# so that expected errors are trapped
# (specially for tools that are not available, like netcat)
# - If the tools are localised to languages != english the script might
# break
# - Ask 'host' maintainer to implement error codes as done with
# dlint
# - Should be able to check if DNS server is in the same network, if
# it doesn't answer to pings, check ARP in that case.
# - DHCP checks?
# - Other internal services tests? (LDAP if using pam...)
# - Generate summary of errors in the end (pretty report?)
# - Check if packets are being dropped by local firewall? (use dmesg
# and look for our tests)
# - Support wireless interfaces? (use iwconfig)
# - Check other TODOs inline in the code
# BEGIN configuration
# Configure to your needs, these values will be used when
# checking DNS and Internet connectivity
# DNS name to resolve
CHECK_HOST=www.debian.org
CHECK_IP_ADRESS=194.109.137.218
# Web server to check for
CHECK_WEB_HOST=www.debian.org
CHECK_WEB_PORT=80
export CHECK_HOST CHECK_IP_ADRESS CHECK_WEB_HOST CHECK_WEB_PORT
# END configuration
PATH=/bin:/sbin:/usr/bin:/usr/sbin
# Check if all commands we need are available
# NOTE: if using nslookup add "nslookup dnsutils"
( echo -e "netstat net-tools\nifconfig net-tools\nping netkit-ping\n\
arp net-tools\nip iproute\nhost bind9-host\nmktemp debianutils\nnc netcat" |
while read cmd package; do
if ! `which $cmd 2>/dev/null >&2`; then
echo "$cmd is not available! (please install $package)" >&2
exit 1
fi
done ) || exit 1
# Extract the interface of our default route
defaultif=`netstat -nr |grep ^0.0.0.0 | awk '{print $8}' | head -1`
defaultroutes=`netstat -nr |grep ^0.0.0.0 | wc -l`
if [ -z "$defaultif" ] ; then
defaultif=none
echo "WARN: This system does not have a default route"
elif [ "$defaultroutes" -gt 1 ] ; then
echo "WARN: This system has more than one default route"
else
echo "INFO: This system has exactly one default route"
fi
# Check loopback
check_local () {
# Is there a loopback interface?
if [ -n "`ip link show lo`" ] ; then
# OK, can we ping localhost
if ! check_host localhost 1; then
# Check 127.0.0.1 instead (not everybody uses this IP address however,
# although its the one commonly used)
if ! check_host 127.0.0.1 1; then
echo "ERR: Cannot ping localhost (127.0.0.1),
loopback is broken in this system"
else
echo "ERR: Localhost is not answering but
127.0.0.1, check /etc/hosts and verify localhost points to 127.0.0.1"
fi
else
echo "INFO: Loopback interface is working properly"
fi
else
echo "ERR: There is no loopback interface in this system"
status=1
fi
status=0
return $status
}
# Check network interfaces
check_if () {
ifname=$1
status=0
[ -z "$ifname" ] && return 1
# Find IP addresses for $ifname
inetaddr=`ip addr show $ifname | grep inet | awk '{print $2}'`
if [ -z "$inetaddr" ] ; then
echo "WARN: The $ifname interface does not have an IP address
assigned"
status=1
else
# TODO: WARN if more than 2 IP addresses?
echo $inetaddr | while read ipaddr; do
echo "INFO: The $ifname interface has IP address
$ipaddr assigned"
done
fi
# Lookup TX and RX statistics
# TODO: This is done using ifconfig but could use /proc/net/dev for
# more readibility or, better, 'netstat -i'
txpkts=`ifconfig $ifname | awk '/RX packets/ { print $2 }' |sed
's/.*://'`
rxpkts=`ifconfig $ifname | awk '/RX packets/ { print $2 }' |sed
's/.*://'`
txerrors=`ifconfig $ifname | awk '/TX packets/ { print $3 }' |sed
's/.*://'`
rxerrors=`ifconfig $ifname | awk '/RX packets/ { print $3 }' |sed
's/.*://'`
# TODO: Check also frames and collisions, to detect faulty cables
# or network devices (cheap hubs)
if [ "$txpkts" -eq 0 ] && [ "$rxpkts" -eq 0 ] ; then
echo "ERR: The $ifname interface has not tx or rx any packets.
Link down?"
status=1
elif [ "$txpkts" -eq 0 ]; then
echo "WARN: The $ifname interface has not transmitted any
packets."
elif [ "$rxpkts" -eq 0 ] ; then
echo "WARN: The $ifname interface has not received any packets."
else
echo "INFO: The $ifname interface has tx and rx packets."
fi
# TODO: It should be best if there was a comparison with tx/rx packets.
# a few errors are not uncommon if the card has been running for a long
# time. It would be better if a relative comparison was done (i.e.
# less than 1% ok, more than 20% warning, over 80% major issue, etc.)
if [ "$txerrors" -ne 0 ]; then
echo "WARN: The $ifname interface has tx errors."
fi
if [ "$rxerrors" -ne 0 ]; then
echo "WARN: The $ifname interface has rx errors."
fi
return $status
}
check_netif () {
status=0
ip link show | egrep '^[[:digit:]]' |
while read ifnumber ifname status extra; do
ifname=`echo $ifname |sed -e 's/:$//'`
if [ -z "`echo $status | grep UP\>`" ] ; then
if [ "$ifname" = "$defaultif" ] ; then
echo "ERR: The $ifname interface that is
associated with your defualt route is down!"
status=1
elif [ "$ifname" = "lo" ] ; then
echo "ERR: Your lo inteface is down, this might
cause issues with local applications (but not necessarily with network
connectivity)"
else
echo "WARN: The $ifname interface is down"
fi
else
# Check network routes associated with this interface
echo "INFO: The $ifname interface is up"
check_if $ifname
check_netroute $ifname
fi
done
return $status
}
check_netroute () {
ifname=$1
[ -z "$ifname" ] && return 1
netstat -nr | grep "${ifname}$" |
while read network gw netmask flags mss window irtt iface; do
# For each gw that is not the default one, ping it
if [ "$gw" != "0.0.0.0" ] ; then
if ! check_router $gw ; then
echo "ERR: The default route is not available
since the default router is unreachable"
fi
fi
done
}
check_router () {
# Checks if a router is up
router=$1
[ -z "$router" ] && return 1
status=0
# First ping the router, if it does not answer then check arp tables and
# see if we have an arp. We use 5 packets since it is in our local network.
ping -q -c 5 "$router" >/dev/null 2>&1
if [ "$?" -ne 0 ]; then
echo "WARN: Router $router does not answer to ICMP pings"
# Router does not answer, check arp
routerarp=`arp -n | grep "^$router" | grep -v incomplete`
if [ -z "$routerarp" ] ; then
echo "ERR: We cannot retrieve a MAC address for router
$router"
status=1
fi
fi
if [ "$status" -eq 0 ] ; then
echo "INFO: The router $router is reachable"
fi
return $status
}
check_host () {
# Check if a host is reachable
# TODO:
# - if the host is in our local network (no route needs to be used) then
# check ARP availability
# - if the host is not on our local network then check if we have a route
# for it
host=$1
[ -z "$host" ] && return 1
# Use 10 packets as we expect this to be outside of our network
COUNT=10
[ -n "$2" ] && COUNT=$2
status=0
ping -q -c $COUNT "$host" >/dev/null 2>&1
if [ "$?" -ne 0 ]; then
echo "WARN: Host $host does not answer to ICMP pings"
status=1
else
echo "INFO: Host $host answers to ICMP pings"
fi
return $status
}
check_dns () {
# Check the nameservers defined in /etc/resolv.conf
status=1
nsfound=0
nsok=0
tempfile=`mktemp tmptestnet.XXXXXX` || { echo "ERR: Cannot create
temporary file! Aborting! " >&2 ; exit 1; }
trap " [ -f \"$tempfile\" ] && /bin/rm -f -- \"$tempfile\"" 0 1 2 3 13
15
cat /etc/resolv.conf |grep nameserver |
awk '/nameserver/ { for (i=2;i<=NF;i++) { print $i ; } }' >$tempfile
for nameserver in `cat $tempfile`; do
nsfound=$(( $nsfound + 1 ))
echo "INFO: This system is configured to use nameserver
$nameserver"
check_host $nameserver 5
if check_ns $nameserver ; then
nsok=$(( $nsok +1 ))
else
status=$?
fi
done
#Could also do:
#nsfound=`wc -l $tempfile | awk '{print $1}'`
/bin/rm -f -- "$tempfile"
trap 0 1 2 3 13 15
if [ "$nsfound" -eq 0 ] ; then
echo "ERR: The system does not have any nameserver configured"
else
if [ "$status" -ne 0 ] ; then
if [ "$nsfound" -eq 1 ] ; then
echo -e "ERR: There is one nameserver
configured for this system but it does not work properly"
else
echo "ERR: There are $nsfound nameservers
configured for this system and none of them works properly"
fi
else
if [ "$nsfound" -eq 1 ] ; then
echo "INFO: The nameserver configured for this
system works properly"
else
echo "INFO: There are $nsfound nameservers is
configured for this system and $nsok are working properly"
fi
fi
fi
return $status
}
check_ns () {
# Check the nameserver using host
# TODO: use nslookup?
# nslookup $CHECK_HOST -$nameserver
nameserver=$1
[ -z "$nameserver" ] && return 1
status=1
CHECK_RESULT="$CHECK_HOST .* $CHECK_IP_ADDRESS"
# Using dnscheck:
dnscheck=`host -t A $CHECK_HOST $nameserver 2>&1 | tail -1`
if [ -n "`echo $dnscheck |grep NXDOMAIN`" ] ; then
echo "ERR: Dns server $nameserver does not resolv properly"
elif [ -n "`echo $dnscheck | grep \"timed out\"`" ] ; then
echo "ERR: Dns server $nameserver is not available"
elif [ -z "`echo $dnscheck | egrep \"$CHECK_RESULT\"`" ] ; then
echo "WARN: Dns server $nameserver did not return the expected
result for $CHECK_HOST"
else
echo "INFO: Dns server $nameserver resolved correctly
$CHECK_HOST"
status=0
fi
# Using dlint
# dlint $CHECK_HOST @$nameserver >/dev/null 2>&1
# if [ $? -eq 2 ] ; then
# echo "ERR: Dns server $nameserver does not resolv properly"
# elif [ $? -ne 0 ]; then
# echo "ERR: Unexpected error when testing $nameserver"
# else
# echo "INFO: Dns server $nameserver resolved correctly
$CHECK_HOST"
# status=0
# fi
return $status
}
check_conn () {
# Checks network connectivity
if ! check_host $CHECK_WEB_HOST >/dev/null ; then
echo "WARN: System does not seem to reach Internet host
$CHECK_WEB_HOST through ICMP"
else
echo "INFO: System can reach Internet host $CHECK_WEB_HOST"
fi
status=0
# Check web access, using nc
# TODO:
# - this could also implement proxy checks (if the http_proxy environment is
# defined?)
# - could also check against a valid content copy (otherwise it might be
# fooled by transparent proxies)
echo -e "HEAD / HTTP/1.0\n\n" |nc -w 20 $CHECK_WEB_HOST $CHECK_WEB_PORT
>/dev/null 2>&1
if [ $? -ne 0 ] ; then
echo "ERR: Cannot access web server at Internet host
$CHECK_WEB_HOST"
status=1
else
echo "INFO: System can access web server at Internet host
$CHECK_WEB_HOST"
fi
return $status
}
# TODO: checks could be conditioned, i.e. if there is no proper
# interface setup don't bother with DNS and don't do some Inet checks
# if DNS is not setup properly
check_local || exit 1
check_netif || exit 1
check_dns || exit 1
check_conn || exit 1
exit 0
signature.asc
Description: Digital signature
--- End Message ---
--- Begin Message ---
Source: debian-goodies
Source-Version: 0.24
We believe that the bug you reported is fixed in the latest version of
debian-goodies, which is due to be installed in the Debian FTP archive:
debian-goodies_0.24.dsc
to pool/main/d/debian-goodies/debian-goodies_0.24.dsc
debian-goodies_0.24.tar.gz
to pool/main/d/debian-goodies/debian-goodies_0.24.tar.gz
debian-goodies_0.24_all.deb
to pool/main/d/debian-goodies/debian-goodies_0.24_all.deb
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to [EMAIL PROTECTED],
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Javier Fernandez-Sanguino Pen~a <[EMAIL PROTECTED]> (supplier of updated
debian-goodies package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [EMAIL PROTECTED])
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Format: 1.7
Date: Sun, 23 Jul 2006 21:42:54 +0200
Source: debian-goodies
Binary: debian-goodies
Architecture: source all
Version: 0.24
Distribution: unstable
Urgency: low
Maintainer: Javier Fernandez-Sanguino Pen~a <[EMAIL PROTECTED]>
Changed-By: Javier Fernandez-Sanguino Pen~a <[EMAIL PROTECTED]>
Description:
debian-goodies - Small toolbox-style utilities for Debian systems
Closes: 224857 231470 249818 251353 263471 283401 292585 307694 329723 368227
369494 369762
Changes:
debian-goodies (0.24) unstable; urgency=low
.
* Taking up this package as new maintainer, after talking with Matt
on private mail.
* Fix Frank Lichtenheld's mail in all manpages (Closes: #249818)
* Changes to debget:
- debget --help (or -h) now works as expected. Introduce usage
in the tool to warn on errors when calling it (Closes: #251353)
- Any other options are rejected (as they would be passed on to apt)
- Additional error checking in debget to prevent it from going ahead
when something goes wrong, this includes checking first if the
apt-get dependencies are right and that the package the user asked
us to retrieve exists (Closes: #283401)
- Use apt-cache instead of apt-get to get the version as
'apt-get -q2 -s --reinstall install' requires, for some reason,
super cower powers. This makes it possible to download packages
without satisfying dependencies (Closes: #369494)
- Document the fact that downloading packages from the package cache
is not supported both in the manpage and in the program's output
(Closes: #224857)
* Fix manpage dglob typos as well as the header of the documentation
generated by pod2man (Closes #228302, #305802)
* Have debman use bash as a shell (Closes: #369762)
* Set LC_NUMERIC to 'C' in dpigs as suggested by Bill Allombert (Closes:
#368227)
* Move checkrestart to /usr/sbin (Closes: #329723)
* Have dglob exit with a '1' exit status if no packages match the globbing
pattern (Closes: #292585)
* Make popbugs properly extract the file provided by the user instead of
/var/log/popularity-contest, if requested to (Closes: #263471)
* Fix typo in popbugs.1 manpage (AUTOR -> AUTHOR)
* Include which-pkg-broke Python script contributed by Bill Gribble and
wrote its associated manpage (Closes: #231470)
* Include network-test shell script contributed by myself and
wrote its associated manpage (Closes: #307694)
* Use debhelper compatibility version 4
Files:
31a5dbae1f0210ed4dfc3abc1f1a8fe7 650 utils optional debian-goodies_0.24.dsc
a1446610e694653c43be714591ae7fdf 23447 utils optional
debian-goodies_0.24.tar.gz
6bdf1d7a421505c434458a11cc226325 30696 utils optional
debian-goodies_0.24_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (GNU/Linux)
iQCVAwUBRMVIIvtEPvakNq0lAQJtBgP9GntORq/cJklOP5GnXnyhAVQsBeMxykCG
6aiGIAnHDrIByVHG48OqltL207bwM+o40Ndll9tmlVL875kKiJdqIAbgplo8WzUE
BG+TVafWj1d2JR9+/YjBwMgF2zJJ6AdbbPP71IUnmrcP0AmCamKMQjdpQ2cbiDZf
tuIJljN8t8E=
=xZ0T
-----END PGP SIGNATURE-----
--- End Message ---
