Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

rtsold

Router solicitation daemon

Syntax:

rtsold [-1Ddfm] interface ...
rtsol [-Dd] interface ...        

Runs on:

Neutrino

Options:

-1
Perform only one probe. Send Router Solicitation packets until valid Router Advertisement packets arrive from all the interfaces, then exit.
-D
Increase the debugging level. Also print internal timer information.
-d
Enable debugging.
-f
Prevent rtsold from becoming a daemon (foreground mode). Warning messages are generated to standard error output, instead of syslog().
-m
Enable mobility support; send probing packets to the default routers that advertised Router Advertisements when the node (re)attached to an interface. Periodically send Router Solicitation on an interface that doesn't support SIOCGIFMEDIA ioctl.
interface
Name of the interface(s) where messages are to be sent.

Description:

The rtsold daemon sends 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.

If you use rtsol, probes are transmitted from the interface specified, without becoming a daemon. It behaves the same as:

rtsold -f1 interface

The rtsold daemon sends at most three Router Solicitations on an interface after one of the following events:

Once rtsold sends a Router Solicitation, and receives 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 its link-layer address.

When a SIGUSR1 signal is received, rtsold dumps the current internal state into /var/run/rtsold.dump.

Files:

/var/run/rtsold.pid
The pid of the currently running rtsold.
/var/run/rtsold.dump
Dump of the current internal state.

Exit status:

0
Successful completion.
Nonzero
An error occurred.

Caveats:

Before this utility will work, you need to enable the TCP/IP stack to accept route advertisements, like this:

sysctl -w net.inet6.ip6.accept_rtadv=1

See also:

rtadvd, sysctl