Package: ndisc6 Version: 0.9.8-1 Severity: minor Tags: patch upstream Hi,
I'm supplying a patch that adds exit code descriptions to the manual pages according to what I've found in the source code. Also, it fixes some minor issues with them. -- System Information: Debian Release: wheezy/sid APT prefers unstable APT policy: (500, 'unstable'), (500, 'testing'), (500, 'stable'), (1, 'experimental') Architecture: i386 (i686) Kernel: Linux 2.6.38-1-686 (SMP w/2 CPU cores) Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8) (ignored: LC_ALL set to en_GB.UTF-8) Shell: /bin/sh linked to /bin/dash Versions of packages ndisc6 depends on: ii libc6 2.11.2-2 Embedded GNU C Library: Shared lib ii perl 5.10.1-16 Larry Wall's Practical Extraction ndisc6 recommends no packages. ndisc6 suggests no packages. -- debconf-show failed -- debsums errors found: debsums: missing file /usr/share/locale/fr/LC_MESSAGES/ndisc6.mo (from ndisc6 package)
--- a/doc/ndisc6.8 +++ b/doc/ndisc6.8 @@ -16,8 +16,8 @@ .SH NAME ndisc6 \- ICMPv6 Neighbor Discovery tool .SH SYNOPSIS -.BR "ndisc6" " [" "-1mnqv" "] [" "-r attempts" "] [" "-w wait_ms" "] <" -.BR "IPv6 address" "> <" "iface" ">" +.BR "ndisc6" " [" "-1mnqv" "] [" "-r attempts" "] [" "-w wait_ms" "]" +.BR "" "<" "IPv6 address" "> <" "iface" ">" .SH DESCRIPTON .B NDisc6 @@ -73,6 +73,13 @@ By default, ndisc6 waits 1 second between each attempts (RETRANS_TIMER from RFC2461). +.PP +.RB "If " "ndisc6" " does not receive any response after the specified number" +.RI "of attempts waiting for " "wait_ms" " milliseconds each time, it will" +exit with code 2. On error, it exits with code 1. +Otherwise it exits with code 0. This makes it possible to use the exit +code to see if a host is on-link or not. + .SH DIAGNOSTICS If you get no response while you know the remote host is up, it is @@ -82,12 +89,13 @@ (i.e. Ethernet segment), for the sake of security. Technically, that is done by ensuring that the Hop limit (TTL) is 255. -Note that you cannot use ndisc6 to lookup the local host's link-layer +.RB "Note that you cannot use " "ndisc6" " to lookup the local host's link-layer" address. .SH SECURITY -.RI "ndisc6 should be " "setuid" " " "root" " to allow use by non " -privileged users. It will drop its root privileges before any attempt +.RB "" "ndisc6" " " +.RI "should be " "setuid" " " "root" " to allow use by" +non-privileged users. It will drop its root privileges before any attempt is made to send or receive data from the network to reduce the possible impact of a security vulnerability. --- a/doc/rdisc6.8 +++ b/doc/rdisc6.8 @@ -16,8 +16,8 @@ .SH NAME rdisc \- ICMPv6 Router Discovery tool .SH SYNOPSIS -.BR "rdisc6" " [" "-qv" "] [" "-r attempts" "] [" "-w wait_ms" "] [" -.BR "IPv6 address" "] <" "iface" ">" +.BR "rdisc6" " [" "-qv" "] [" "-r attempts" "] [" "-w wait_ms" "]" +.BR "" "[" "IPv6 address" "] <" "iface" ">" .SH DESCRIPTON .B RDisc6 @@ -75,8 +75,15 @@ By default, rdisc6 waits 4 second between each attempts (RTR_SOLICITATION_INTERVAL from RFC2461). +.PP +.RB "If " "rdisc6" " does not receive any response after the specified number" +.RI "of attempts waiting for " "wait_ms" " milliseconds each time, it will" +exit with code 2. On error, it exits with code 1. +Otherwise it exits with code 0. + .SH SECURITY -.RI "rdisc6 must be " "setuid" " " "root" " to allow use by non " +.RB "" "rdisc6" " " +.RI "must be " "setuid" " " "root" " to allow use by non " privileged users. It will drop its root privileges before any attempt is made to send or receive data from the network to reduce the possible impact of a security vulnerability.