Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
RDISC6(8)		     System Manager's Manual		       RDISC6(8)

NAME
     rdisc - ICMPv6 Router Discovery tool

SYNOPSIS
     rdisc6  [-qv]  [-r  attempts]  [-s  source_ip]  [-w wait_ms] [IPv6 address]
     <iface>

DESCRIPTON
     RDisc6 is an Unix program which implements the ICMPv6 Router  Discovery  in
     userland (it is normally done by the kernel). It is used to lookup the list
     of on-link routers and IPv6 prefixes.

     It  can  also  be	used  to force the kernel to update the state of a given
     IPv6-autoconfigured network interface.

     The name of the network interface to probe routers for must be specified.

OPTIONS
     -1 or --single
	    Exit as soon as the first advertisement is received.

     -h or --help
	    Display some help and exit.

     -m or --multiple
	    Wait for possible multiple advertisements and print all of them (de-
	    fault).

     -n or --numeric
	    If the optional parameter is not a valid IPv6 address, do not try to
	    resolve it as a DNS hostname.

     -q or --quiet
	    Only display advertised IPv6 prefixes. Display nothing  in	case  of
	    failure.   That  is  mostly  useful  when calling the program from a
	    shell script.

     -r attempts or --retry attempts
	    Send ICMPv6 Router Discovery that many times until a  reply  is  re-
	    ceived,  or abort. By default, rdisc6 will try 3 times before abort-
	    ing (MAX_RTR_SOLICITATIONS from RFC2461).

     -s source_ip or --source source_ip
	    Specify the IPv6 address to be used as the source for the router so-
	    licitation packets.

     -V or --version
	    Display program version and license and exit.

     -v or --verbose
	    Display verbose information. That is the default.

     -w wait_ms or --wait wait_ms
	    Wait wait_ms milliseconds for a response before  retrying.	 By  de-
	    fault,  rdisc6  waits  4 second between each attempts (RTR_SOLICITA-
	    TION_INTERVAL from RFC2461).

     If rdisc6 does not receive any response after the specified number  of  at-
     tempts  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.

SECURITY
     rdisc6 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.

SEE ALSO
     ndisc6(8), ipv6(7)

AUTHOR
     Remi Denis-Courmont <remi at remlab dot net>

     http://www.remlab.net/ndisc6/

rdisc6				     $Date$			       RDISC6(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rdisc6&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help