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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
RTSOLD(8)		FreeBSD	System Manager's Manual		     RTSOLD(8)

NAME
     rtsold, rtsol -- router solicitation daemon

SYNOPSIS
     rtsold [-dDfFmu1] [-O script-name]	[-p pidfile] [-R script-name]
	    interface ...
     rtsold [-dDfFmu1] [-O script-name]	[-p pidfile] [-R script-name] -a
     rtsol [-dDu] [-O script-name] [-R script-name] interface ...
     rtsol [-dDu] [-O script-name] [-R script-name] -a

DESCRIPTION
     rtsold is the daemon program to send ICMPv6 Router	Solicitation messages
     on	the specified interfaces.  If a	node (re)attaches to a link, rtsold
     sends some	Router Solicitations on	the link destined to the link-local
     scope all-routers multicast address to discover new routers and to	get
     non link-local addresses.

     rtsold should be used on IPv6 hosts (non-router nodes) only.

     If	you invoke the program as rtsol, it will transmit probes from the
     specified interface, without becoming a daemon.  In other words, rtsol
     behaves as	``rtsold -f1 interfaces''.

     Specifically, rtsold sends	at most	3 Router Solicitations on an interface
     after one of the following	events:

     +o	 Just after invocation of rtsold daemon.
     +o	 The interface is up after a temporary interface failure.  rtsold
	 detects such failures by periodically probing to see if the status of
	 the interface is active or not.  Note that some network cards and
	 drivers do not	allow the extraction of	link state.  In	such cases,
	 rtsold	cannot detect the change of the	interface status.
     +o	 Every 60 seconds if the -m option is specified	and the	rtsold daemon
	 cannot	get the	interface status.  This	feature	does not conform to
	 the IPv6 neighbor discovery specification, but	is provided for	mobile
	 stations.  The	default	interval for router advertisements, which is
	 on the	order of 10 minutes, is	slightly long for mobile stations.
	 This feature is provided for such stations so that they can find new
	 routers as soon as possible when they attach to another link.

     Once rtsold has sent a Router Solicitation, and has received a valid
     Router Advertisement, it refrains from sending additional solicitations
     on	that interface,	until the next time one	of the above events occurs.

     When sending a Router Solicitation	on an interface, rtsold	includes a
     Source Link-layer address option if the interface has a link-layer
     address.

     rtsold manages a per-interface parameter to detect	if a separate protocol
     is	needed for configuration parameters other than host's addresses.  At
     the invocation time, the flag is FALSE, and becomes TRUE when the daemon
     receives a	router advertisement with the OtherConfig flag being set.  A
     script file can be	specified to deal with the case	(see below).  When
     rtsold start resending router solicitation	messages by one	of the condi-
     tions events, the daemon resets the parameter because the event may indi-
     cate a change on the attached link.

     Upon receipt of signal SIGUSR1, rtsold will dump the current internal
     state into	/var/run/rtsold.dump.

     The options are as	follows:

     -a	     Autoprobe outgoing	interface.  rtsold will	try to find a non-
	     loopback, non-point-to-point, IPv6-capable	interface.  If rtsold
	     finds multiple interfaces,	rtsold will exit with error.

     -d	     Enable debugging.

     -D	     Enable more debugging including the printing of internal timer
	     information.

     -f	     Prevent rtsold from becoming a daemon (foreground mode).  Warning
	     messages are generated to standard	error instead of syslog(3).

     -F	     Explicitly	configure the kernel to	accept Router Advertisements
	     and disable IPv6 forwarding.  These settings are required for
	     proper rtsold operation.  Without this option, the	current	set-
	     tings will	be obeyed; if they are incompatible with proper	opera-
	     tion, warning messages will be generated, but Router Solicita-
	     tions will	still be sent.	The settings may be changed manually
	     with sysctl(8) and	ifconfig(8).

     -m	     Enable mobility support.  If this option is specified, rtsold
	     sends probing packets to default routers that have	advertised
	     Router Advertisements when	the node (re)attaches to an interface.
	     Moreover, if the option is	specified, rtsold periodically sends
	     Router Solicitation on an interface that does not support
	     SIOCGIFMEDIA ioctl.

     -1	     Perform only one probe.  Transmit Router Solicitation packets
	     until at least one	valid Router Advertisement packet has arrived
	     on	each interface,	then exit.

     -O	script-name
	     Specifies a supplement script file	to handle the Other Configura-
	     tion flag of the router advertisement.  When the flag changes
	     from FALSE	to TRUE, rtsold	will invoke script-name	with a single
	     argument of the receiving interface name, expecting the script
	     will then start a protocol	for the	other configuration.
	     script-name must be the absolute path from	root to	the script
	     file, be a	regular	file, and be created by	the same owner who
	     runs rtsold.

     -p	pidfile
	     Writes the	process	ID of rtsold to	pidfile	instead	of the default
	     PID file /var/run/rtsold.pid.

     -R	script-name
	     Specifies a script	to run when router advertisment	options	RDNSS
	     (Recursive	DNS Server) or DNSSL (DNS Search List) are encoun-
	     tered.  The information of	DNS servers and	DNS search domains
	     will be sent to standard input of this script.  The resolvconf(8)
	     script is used by default.

     -u	     Specifies whether adding the source address of Router Advertise-
	     ment messages to the interface name in an argument	of the RDNSS
	     and DNSSL script.

	     If	-u is specified, the interface name in the script argument
	     will be `ifname:slaac:[RA-source-address]'.

	     If	not, it	will be	`ifname:slaac'.

FILES
     /var/run/rtsold.pid   the pid of the currently running rtsold.
     /var/run/rtsold.dump  dumps internal state	on.

EXIT STATUS
     The rtsold	utility	exits 0	on success, and	>0 if an error occurs.

SEE ALSO
     resolvconf(8), rtadvd(8), sysctl(8)

HISTORY
     The rtsold	command	is based on the	rtsol command, which first appeared in
     WIDE/KAME IPv6 protocol stack kit.	 rtsol is now integrated into
     rtsold(8).

BUGS
     In	some operating systems,	when a PCMCIA network card is removed and
     reinserted, the corresponding interface index is changed.	However,
     rtsold assumes such changes will not occur, and always uses the index
     that it got at invocation.	 As a result, rtsold may not work if you rein-
     sert a network card.  In such a case, rtsold should be killed and
     restarted.

     The IPv6 autoconfiguration	specification assumes a	single-interface host.
     You may see kernel	error messages if you try to autoconfigure a host with
     multiple interfaces.  Also, it seems contradictory	for rtsold to accept
     multiple interface	arguments.

FreeBSD	9.3			 June 14, 2011			   FreeBSD 9.3

NAME | SYNOPSIS | DESCRIPTION | FILES | EXIT STATUS | SEE ALSO | HISTORY | BUGS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=rtsold&sektion=8&manpath=FreeBSD+9.0-RELEASE>

home | help