| rtadvd.8 (71333) | rtadvd.8 (78064) |
|---|---|
| 1.\" $FreeBSD: head/usr.sbin/rtadvd/rtadvd.8 71333 2001-01-21 15:25:46Z itojun $ 2.\" $KAME: rtadvd.8,v 1.9 2000/05/27 13:37:01 jinmei Exp $ | 1.\" $FreeBSD: head/usr.sbin/rtadvd/rtadvd.8 78064 2001-06-11 12:39:29Z ume $ 2.\" $KAME: rtadvd.8,v 1.17 2001/02/04 05:34:38 jinmei Exp $ |
| 3.\" 4.\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. 5.\" All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright --- 20 unchanged lines hidden (view full) --- 31.Dd May 17, 1998 32.Dt RTADVD 8 33.Os 34.Sh NAME 35.Nm rtadvd 36.Nd router advertisement daemon 37.Sh SYNOPSIS 38.Nm | 3.\" 4.\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. 5.\" All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright --- 20 unchanged lines hidden (view full) --- 31.Dd May 17, 1998 32.Dt RTADVD 8 33.Os 34.Sh NAME 35.Nm rtadvd 36.Nd router advertisement daemon 37.Sh SYNOPSIS 38.Nm |
| 39.Op Fl dDfMRs |
|
| 39.Op Fl c Ar configfile | 40.Op Fl c Ar configfile |
| 40.Op Fl dDfRs | |
| 41.Ar interface ... 42.Sh DESCRIPTION 43.Nm 44sends router advertisement packets to the specified 45.Ar interfaces . 46.Pp 47The program will daemonize itself on invocation. 48It will then send router advertisement packets periodically, as well --- 23 unchanged lines hidden (view full) --- 72The 73.Fl s 74option may be used to disable this behavior. 75Moreover, if the status of an advertising interface changes, 76.Nm 77will start or stop sending router advertisements according 78to the latest status. 79.Pp | 41.Ar interface ... 42.Sh DESCRIPTION 43.Nm 44sends router advertisement packets to the specified 45.Ar interfaces . 46.Pp 47The program will daemonize itself on invocation. 48It will then send router advertisement packets periodically, as well --- 23 unchanged lines hidden (view full) --- 72The 73.Fl s 74option may be used to disable this behavior. 75Moreover, if the status of an advertising interface changes, 76.Nm 77will start or stop sending router advertisements according 78to the latest status. 79.Pp |
| 80Basically, hosts MUST NOT send Router Advertisement messages at any 81time (RFC 2461, Section 6.2.3). 82However, it would sometimes be useful to allow hosts to advertise some 83parameters such as prefix information and link MTU. 84Thus, 85.Nm 86can be invoked if router lifetime is explicitly set zero on every 87advertising interface. 88.Pp |
|
| 80The command line options are: 81.Bl -tag -width indent 82.\" 83.It Fl c 84Specify an alternate location, 85.Ar configfile , 86for the configuration file. 87By default, 88.Pa /etc/rtadvd.conf 89is used. 90.It Fl d 91Print debugging information. 92.It Fl D 93Even more debugging information is printed. 94.It Fl f 95Foreground mode (useful when debugging). | 89The command line options are: 90.Bl -tag -width indent 91.\" 92.It Fl c 93Specify an alternate location, 94.Ar configfile , 95for the configuration file. 96By default, 97.Pa /etc/rtadvd.conf 98is used. 99.It Fl d 100Print debugging information. 101.It Fl D 102Even more debugging information is printed. 103.It Fl f 104Foreground mode (useful when debugging). |
| 105.It Fl M 106Specify an interface to join the all-routers site-local multicast group. 107By default, 108.Nm 109tries to join the first advertising interface appeared in the command 110line. 111This option has meaning only with the 112.Fl R 113option, which enables routing renumbering protocol support. |
|
| 96.\".It Fl m 97.\"Enables mobile IPv6 support. 98.\"This changes the content of router advertisement option, as well as 99.\"permitted configuration directives. 100.It Fl R 101Accept router renumbering requests. 102If you enable it, certain IPsec setup is suggested for security reasons. | 114.\".It Fl m 115.\"Enables mobile IPv6 support. 116.\"This changes the content of router advertisement option, as well as 117.\"permitted configuration directives. 118.It Fl R 119Accept router renumbering requests. 120If you enable it, certain IPsec setup is suggested for security reasons. |
| 121On KAME-based systems, 122.Xr rrenumd 8 123generates router renumbering request packets. 124This option is currently disabled, and is ignored by 125.Nm 126with a warning message. |
|
| 103.It Fl s 104Do not add or delete prefixes dynamically. 105Only statically configured prefixes, if any, will be advertised. 106.El 107.Pp 108Upon receipt of signal 109.Dv SIGUSR1 , 110.Nm --- 22 unchanged lines hidden (view full) --- 133contains the pid of the currently running 134.Nm . 135.It Pa /var/run/rtadvd.dump 136in which 137.Nm 138dumps its internal state. 139.El 140.Sh SEE ALSO | 127.It Fl s 128Do not add or delete prefixes dynamically. 129Only statically configured prefixes, if any, will be advertised. 130.El 131.Pp 132Upon receipt of signal 133.Dv SIGUSR1 , 134.Nm --- 22 unchanged lines hidden (view full) --- 157contains the pid of the currently running 158.Nm . 159.It Pa /var/run/rtadvd.dump 160in which 161.Nm 162dumps its internal state. 163.El 164.Sh SEE ALSO |
| 141.Xr daemon 3 , | |
| 142.Xr rtadvd.conf 5 , | 165.Xr rtadvd.conf 5 , |
| 143.Xr rtsol 8 | 166.Xr rtsol 8 , 167.Xr rrenumd 8 |
| 144.Sh HISTORY 145The 146.Nm 147command first appeared in WIDE Hydrangea IPv6 protocol stack kit. 148.Sh CAVEAT | 168.Sh HISTORY 169The 170.Nm 171command first appeared in WIDE Hydrangea IPv6 protocol stack kit. 172.Sh CAVEAT |
| 149Router advertisements should only be performed downstream. 150Erroneous upstream advertisements will cause | 173There used to be some text that recommended users not to let 174.Nm 175advertise Router Advertisement messages on an upstream link to avoid 176undesirable |
| 151.Xr icmp6 4 | 177.Xr icmp6 4 |
| 152redirect packet storms in the subnet, as (per the specification) the 153advertising router is assumed to become the default router for 154end hosts in the subnet. | 178redirect messages. 179However, based on the later discussion in the IETF ipng working group, 180all routers should rather advertise the messages regardless of 181the network topology, in order to ensure reachability. |