rtsold.8 (68965) | rtsold.8 (78064) |
---|---|
1.\" $KAME: rtsold.8,v 1.14 2000/08/13 18:06:39 itojun Exp $ | 1.\" $KAME: rtsold.8,v 1.16 2000/10/15 13:19:05 itojun Exp $ |
2.\" 3.\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright --- 12 unchanged lines hidden (view full) --- 22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28.\" SUCH DAMAGE. 29.\" | 2.\" 3.\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright --- 12 unchanged lines hidden (view full) --- 22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28.\" SUCH DAMAGE. 29.\" |
30.\" $FreeBSD: head/usr.sbin/rtsold/rtsold.8 68965 2000-11-20 20:10:44Z ru $ | 30.\" $FreeBSD: head/usr.sbin/rtsold/rtsold.8 78064 2001-06-11 12:39:29Z ume $ |
31.\" 32.Dd May 17, 1998 33.Dt RTSOLD 8 | 31.\" 32.Dd May 17, 1998 33.Dt RTSOLD 8 |
34.Os KAME | 34.Os |
35.\" 36.Sh NAME 37.Nm rtsold 38.Nd router solicitation daemon 39.\" 40.Sh SYNOPSIS 41.Nm 42.Op Fl dDfm1 --- 14 unchanged lines hidden (view full) --- 57on the specified interfaces. 58If a node (re)attaches to a link, 59.Nm 60sends some Router Solicitations on the link destined to the link-local scope 61all-routers multicast address to discover new routers 62and to get non link-local addresses. 63.Pp 64.Nm | 35.\" 36.Sh NAME 37.Nm rtsold 38.Nd router solicitation daemon 39.\" 40.Sh SYNOPSIS 41.Nm 42.Op Fl dDfm1 --- 14 unchanged lines hidden (view full) --- 57on the specified interfaces. 58If a node (re)attaches to a link, 59.Nm 60sends some Router Solicitations on the link destined to the link-local scope 61all-routers multicast address to discover new routers 62and to get non link-local addresses. 63.Pp 64.Nm |
65should be used on IPv6 host 66.Pq non-router node | 65should be used on IPv6 hosts 66.Pq non-router nodes |
67only. 68.Pp 69If you invoke the program as 70.Nm rtsol , 71it will transmit probes from the specified 72.Ar interface , 73without becoming a daemon. 74In other words, --- 26 unchanged lines hidden (view full) --- 101.Nm 102cannot detect the change of the interface status. 103.It 104Every 60 seconds if the 105.Fl m 106option is specified and the 107.Nm 108daemon cannot get the interface status. | 67only. 68.Pp 69If you invoke the program as 70.Nm rtsol , 71it will transmit probes from the specified 72.Ar interface , 73without becoming a daemon. 74In other words, --- 26 unchanged lines hidden (view full) --- 101.Nm 102cannot detect the change of the interface status. 103.It 104Every 60 seconds if the 105.Fl m 106option is specified and the 107.Nm 108daemon cannot get the interface status. |
109This feature does not conform to IPv6 neighbor discovery | 109This feature does not conform to the IPv6 neighbor discovery |
110specification, but is provided for mobile stations. | 110specification, but is provided for mobile stations. |
111Default interval for router advertisements, which is on the order of 10 | 111The default interval for router advertisements, which is on the order of 10 |
112minutes, is slightly long for mobile stations. 113This feature is provided 114for such stations so that they can find new routers as soon as possible 115when they attach to another link. 116.El 117.Lp 118Once 119.Nm | 112minutes, is slightly long for mobile stations. 113This feature is provided 114for such stations so that they can find new routers as soon as possible 115when they attach to another link. 116.El 117.Lp 118Once 119.Nm |
120sends a Router Solicitation, and receives a valid Router Advertisement, | 120has sent a Router Solicitation, and has received a valid Router Advertisement, |
121it refrains from sending additional solicitations on that interface, until 122the next time one of the above events occurs. 123.Lp 124When sending a Router Solicitation on an interface, 125.Nm 126includes a Source Link-layer address option if the interface | 121it refrains from sending additional solicitations on that interface, until 122the next time one of the above events occurs. 123.Lp 124When sending a Router Solicitation on an interface, 125.Nm 126includes a Source Link-layer address option if the interface |
127has its link-layer address. | 127has a link-layer address. |
128.Pp 129Upon receipt of signal 130.Dv SIGUSR1 , 131.Nm 132will dump the current internal state into 133.Pa /var/run/rtsold.dump . 134.\" 135.Sh OPTIONS 136.Bl -tag -width indent 137.It Fl a 138Autoprobe outgoing interface. 139.Nm | 128.Pp 129Upon receipt of signal 130.Dv SIGUSR1 , 131.Nm 132will dump the current internal state into 133.Pa /var/run/rtsold.dump . 134.\" 135.Sh OPTIONS 136.Bl -tag -width indent 137.It Fl a 138Autoprobe outgoing interface. 139.Nm |
140will try to find a non-loopback, non-p2p and IPv6-capable, interface. | 140will try to find a non-loopback, non-point-to-point, IPv6-capable interface. |
141If 142.Nm 143finds multiple interfaces, 144.Nm 145will exit with error. 146.\" 147.It Fl d 148Enable debugging. 149.It Fl D | 141If 142.Nm 143finds multiple interfaces, 144.Nm 145will exit with error. 146.\" 147.It Fl d 148Enable debugging. 149.It Fl D |
150Enable more debugging including to print internal timer information. | 150Enable more debugging including the printing of internal timer information. |
151.It Fl f 152.Fl f 153prevents 154.Nm 155from becoming a daemon (foreground mode). | 151.It Fl f 152.Fl f 153prevents 154.Nm 155from becoming a daemon (foreground mode). |
156Warning messages are generated to standard error output, | 156Warning messages are generated to standard error |
157instead of 158.Xr syslog 3 . 159.It Fl m 160Enable mobility support. 161If this option is specified, 162.Nm 163sends probing packets to default routers that have advertised Router 164Advertisements 165when the node (re)attaches to an interface. 166Moreover, if the option is specified, 167.Nm 168periodically sends Router Solicitation on an interface that does not support 169.Dv SIOCGIFMEDIA 170ioctl. 171.It Fl 1 172Perform only one probe. | 157instead of 158.Xr syslog 3 . 159.It Fl m 160Enable mobility support. 161If this option is specified, 162.Nm 163sends probing packets to default routers that have advertised Router 164Advertisements 165when the node (re)attaches to an interface. 166Moreover, if the option is specified, 167.Nm 168periodically sends Router Solicitation on an interface that does not support 169.Dv SIOCGIFMEDIA 170ioctl. 171.It Fl 1 172Perform only one probe. |
173Transmit Router Solicitation packet until valid Router Advertisement packet 174arrives all the interfaces more than once, then exit. | 173Transmit Router Solicitation packets until at least one valid Router 174Advertisement packet has arrived on each 175.Ar interface , 176then exit. |
175.El 176.Sh RETURN VALUES | 177.El 178.Sh RETURN VALUES |
177The program exits with 0 on success, non-zero on failures. | 179The 180.Nm 181program exits 0 on success, and >0 on failures. |
178.\" 179.Sh FILES 180.Bl -tag -width /var/run/rtsold.dump -compact 181.It Pa /var/run/rtsold.pid 182the pid of the currently running 183.Nm . 184.It Pa /var/run/rtsold.dump 185dumps internal state on. --- 13 unchanged lines hidden (view full) --- 199is now integrated into 200.Xr rtsold 8 . 201.\" 202.Sh BUGS 203In some operating systems, when a PCMCIA network card is removed 204and reinserted, the corresponding interface index is changed. 205However, 206.Nm | 182.\" 183.Sh FILES 184.Bl -tag -width /var/run/rtsold.dump -compact 185.It Pa /var/run/rtsold.pid 186the pid of the currently running 187.Nm . 188.It Pa /var/run/rtsold.dump 189dumps internal state on. --- 13 unchanged lines hidden (view full) --- 203is now integrated into 204.Xr rtsold 8 . 205.\" 206.Sh BUGS 207In some operating systems, when a PCMCIA network card is removed 208and reinserted, the corresponding interface index is changed. 209However, 210.Nm |
207does not assume such changes, and always uses the index that | 211assumes such changes will not occur, and always uses the index that |
208it got at invocation. As a result, 209.Nm 210may not work if you reinsert a network card. 211In such a case, 212.Nm 213should be killed and restarted. 214.Pp | 212it got at invocation. As a result, 213.Nm 214may not work if you reinsert a network card. 215In such a case, 216.Nm 217should be killed and restarted. 218.Pp |
215IPv6 autoconfiguration specification assumes single interface host. 216You may see kernel error message if you try to autoconfigure a host with | 219The IPv6 autoconfiguration specification assumes a single-interface host. 220You may see kernel error messages if you try to autoconfigure a host with |
217multiple interfaces. 218Also, it seems contradictory for 219.Nm 220to accept multiple | 221multiple interfaces. 222Also, it seems contradictory for 223.Nm 224to accept multiple |
221.Ar interfaces 222in argument. | 225.Ar interface 226arguments. |