1.\" $NetBSD: rtadvd.conf.5,v 1.14 2009/11/01 15:19:19 jakllsch Exp $ 2.\" $KAME: rtadvd.conf.5,v 1.50 2005/01/14 05:30:59 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 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 3. Neither the name of the project nor the names of its contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.Dd November 1, 2009 32.Dt RTADVD.CONF 5 33.Os 34.Sh NAME 35.Nm rtadvd.conf 36.Nd config file for router advertisement daemon 37.Sh DESCRIPTION 38This file describes how the router advertisement packets must be constructed 39for each of the interfaces. 40.Pp 41As described in 42.Xr rtadvd 8 , 43you do not have to set this configuration file up at all, 44unless you need some special configurations. 45You may even omit the file as a whole. 46In such cases, the 47.Nm rtadvd 48daemon will automatically configure itself using default values 49specified in the specification. 50.Pp 51It obeys the famous 52.Xr termcap 5 53file format. 54Each line in the file describes a network interface. 55Fields are separated by a colon 56.Pq Sq \&: , 57and each field contains one capability description. 58Lines may be concatenated by the 59.Sq \e 60character. 61The comment marker is the 62.Sq \&# 63character. 64.Sh CAPABILITIES 65Capabilities describe the value to be filled into ICMPv6 router 66advertisement messages and to control 67.Xr rtadvd 8 68behavior. 69Therefore, you are encouraged to read IETF neighbor discovery documents 70if you would like to modify the sample configuration file. 71.Pp 72Note that almost all items have default values. 73If you omit an item, the default value of the item will be used. 74.Pp 75There are two items which control the interval of sending router advertisements. 76These items can be omitted, then 77.Nm rtadvd 78will use the default values. 79.Bl -tag -width indent 80.It Cm \&maxinterval 81(num) The maximum time allowed between sending unsolicited 82multicast router advertisements 83.Pq unit: seconds . 84The default value is 600. 85Its value must be no less than 4 seconds 86and no greater than 1800 seconds. 87.It Cm \&mininterval 88(num) The minimum time allowed between sending unsolicited multicast 89router advertisements 90.Pq unit: seconds . 91The default value is the one third of value of 92.Cm maxinterval . 93Its value must be no less than 3 seconds and no greater than .75 * 94the value of 95.Cm maxinterval . 96.El 97.Pp 98The following items are for ICMPv6 router advertisement message 99header. 100These items can be omitted, then 101.Nm rtadvd 102will use the default values. 103.Bl -tag -width indent 104.It Cm \&chlim 105(num) The value for Cur Hop Limit field. 106The default value is 64. 107.It Cm \&raflags 108(str or num) A 8-bit flags field in router advertisement message header. 109This field can be specified either as a case-sensitive string or as an 110integer. 111A sting consists of characters each of which corresponds to a 112particular flag bit(s). 113An integer should be the logical OR of all enabled bits. 114Bit 7 115.Po 116.Li 'm' or 0x80 117.Pc 118means Managed address configuration flag bit, 119and Bit 6 120.Po 121.Li 'o' or 0x40 122.Pc 123means Other stateful configuration flag bit. 124Bit 4 125.Po 126.Li 0x10 127.Pc 128and Bit 3 129.Po 130.Li 0x08 131.Pc 132are used to encode router preference. 133Bits 01 134.Po 135or 'h' 136.Pc 137means high, 00 means medium, and 11 138.Po 139or 'l' 140.Pc 141means low. 142Bits 10 is reserved, and must not be specified. 143There is no character to specify the medium preference explicitly. 144The default value of the entire flag is 0 145.Po 146or a null string, 147.Pc 148which means no additional 149configuration methods, and the medium router preference. 150.It Cm \&rltime 151(num) Router lifetime field 152.Pq unit: seconds . 153The value must be either zero or between 154the value of 155.Cm maxinterval 156and 9000. 157When 158.Nm rtadvd 159runs on a host, this value must explicitly set 0 on all the 160advertising interfaces as described in 161.Xr rtadvd 8 . 162The default value is 1800. 163.It Cm \&rtime 164(num) Reachable time field 165.Pq unit: milliseconds . 166The default value is 0, which means unspecified by this router. 167.It Cm \&retrans 168(num) Retrans Timer field 169.Pq unit: milliseconds . 170The default value is 0, which means unspecified by this router. 171.El 172.Pp 173The following items are for ICMPv6 prefix information option, 174which will be attached to router advertisement header. 175These items can be omitted, then 176.Nm rtadvd 177will automatically get appropriate prefixes from the kernel's routing table, 178and advertise the prefixes with the default parameters. 179Keywords other than 180.Cm clockskew 181can be augmented with a number, like 182.Dq Li prefix2 , 183to specify multiple prefixes. 184.Bl -tag -width indent 185.It Cm \&clockskew 186(num) Time skew to adjust link propagation delays and clock skews 187between routers on the link 188.Pq unit: seconds . 189This value is used in consistency check for locally-configured and 190advertised prefix lifetimes, and has its meaning when the local router 191configures a prefix on the link with a lifetime that decrements in 192real time. 193If the value is 0, it means the consistency check will be skipped 194for such prefixes. 195The default value is 0. 196.It Cm \&prefixlen 197(num) Prefix length field. 198The default value is 64. 199.It Cm \&pinfoflags 200(str or num) A 8-bit flags field in prefix information option. 201This field can be specified either as a case-sensitive string or as an 202integer. 203A sting consists of characters each of which corresponds to a 204particular flag bit(s). 205An integer should be the logical OR of all enabled bits. 206Bit 7 207.Po 208.Li 'l' or 0x80 209.Pc 210means On-link flag bit, 211and Bit 6 212.Po 213.Li 'a' or 0x40 214.Pc 215means Autonomous address-configuration flag bit. 216The default value is "la" or 0xc0, i.e., both bits are set. 217.It Cm \&addr 218(str) The address filled into Prefix field. 219Since 220.Dq \&: 221is used for 222.Xr termcap 5 223file format as well as IPv6 numeric address, the field MUST be quoted by 224doublequote character. 225.It Cm \&vltime 226(num) Valid lifetime field 227.Pq unit: seconds . 228The default value is 2592000 (30 days). 229.It Cm \&vltimedecr 230(bool) This item means the advertised valid lifetime will decrement 231in real time, which is disabled by default. 232.It Cm \&pltime 233(num) Preferred lifetime field 234.Pq unit: seconds . 235The default value is 604800 (7 days). 236.It Cm \&pltimedecr 237(bool) This item means the advertised preferred lifetime will decrement 238in real time, which is disabled by default. 239.El 240.Pp 241The following item is for ICMPv6 MTU option, 242which will be attached to router advertisement header. 243This item can be omitted, then 244.Nm rtadvd 245will use the default value. 246.Bl -tag -width indent 247.It Cm \&mtu 248(num or str) MTU (maximum transmission unit) field. 249If 0 is specified, it means that the option will not be included. 250The default value is 0. 251If the special string 252.Dq auto 253is specified for this item, MTU option will be included and its value 254will be set to the interface MTU automatically. 255.El 256.Pp 257The following item controls ICMPv6 source link-layer address option, 258which will be attached to router advertisement header. 259As noted above, you can just omit the item, then 260.Nm rtadvd 261will use the default value. 262.Bl -tag -width indent 263.It Cm \&nolladdr 264(bool) By default 265.Po 266if 267.Cm \&nolladdr 268is not specified 269.Pc , 270.Xr rtadvd 8 271will try to get link-layer address for the interface from the kernel, 272and attach that in source link-layer address option. 273If this capability exists, 274.Xr rtadvd 8 275will not attach source link-layer address option to 276router advertisement packets. 277.El 278.Pp 279The following items are for ICMPv6 route information option, 280which will be attached to router advertisement header. 281These items are optional. 282Each items can be augmented with number, like 283.Dq Li rtplen2 , 284to specify multiple routes. 285.Bl -tag -width indent 286.It Cm \&rtprefix 287(str) The prefix filled into the Prefix field of route information option. 288Since 289.Dq \&: 290is used for 291.Xr termcap 5 292file format as well as IPv6 numeric address, the field MUST be quoted by 293doublequote character. 294.It Cm \&rtplen 295(num) Prefix length field in route information option. 296The default value is 64. 297.It Cm \&rtflags 298(str or num) A 8-bit flags field in route information option. 299Currently only the preference values are defined. 300The notation is same as that of the raflags field. 301Bit 4 302.Po 303.Li 0x10 304.Pc 305and Bit 3 306.Po 307.Li 0x08 308.Pc 309are used to encode the route preference for the route. 310The default value is 0x00, i.e. medium preference. 311.It Cm \&rtltime 312(num) route lifetime field in route information option. 313.Pq unit: seconds . 314Since the specification does not define the default value of this 315item, the value for this item should be specified by hand. 316However, 317.Nm rtadvd 318allows this item to be unspecified, and uses the router lifetime 319as the default value in such a case, just for compatibility with an 320old version of the program. 321.El 322.Pp 323In the above list, each keyword beginning with 324.Dq Li rt 325could be replaced with the one beginning with 326.Dq Li rtr 327for backward compatibility reason. 328For example, 329.Cm rtrplen 330is accepted instead of 331.Cm rtplen . 332However, keywords that start with 333.Dq Li rtr 334have basically been obsoleted, and should not be used any more. 335.Pp 336You can also refer one line from another by using 337.Cm tc 338capability. 339See 340.Xr termcap 5 341for details on the capability. 342.Sh EXAMPLES 343As presented above, all of the advertised parameters have default values 344defined in specifications, and hence you usually do not have to set them 345by hand, unless you need special non-default values. 346It can cause interoperability problem if you use an ill-configured 347parameter. 348.Pp 349To override a configuration parameter, you can specify the parameter alone. 350With the following configuration, 351.Xr rtadvd 8 352overrides the router lifetime parameter for the 353.Li ne0 354interface. 355.Bd -literal 356ne0:\\ 357 :rltime#0: 358.Ed 359.Pp 360The following example manually configures prefixes advertised from the 361.Li ef0 362interface. 363The configuration must be used with the 364.Fl s 365option to 366.Xr rtadvd 8 . 367.Bd -literal 368ef0:\\ 369 :addr="2001:db8:ffff:1000::":prefixlen#64: 370.Ed 371.Pp 372The following example presents the default values in an explicit manner. 373The configuration is provided just for reference purposes; 374YOU DO NOT NEED TO HAVE IT AT ALL. 375.Bd -literal 376default:\\ 377 :chlim#64:raflags#0:rltime#1800:rtime#0:retrans#0:\\ 378 :pinfoflags="la":vltime#2592000:pltime#604800:mtu#0: 379ef0:\\ 380 :addr="2001:db8:ffff:1000::":prefixlen#64:tc=default: 381.Ed 382.Sh SEE ALSO 383.Xr termcap 5 , 384.Xr rtadvd 8 , 385.Xr rtsol 8 386.Pp 387Thomas Narten, Erik Nordmark and W. A. Simpson, 388.Do 389Neighbor Discovery for IP version 6 (IPv6) 390.Dc , 391RFC 2461 392.Pp 393Richard Draves, 394.Do 395Default Router Preferences and More-Specific Routes 396.Dc , 397RFC 4191 398.Sh HISTORY 399The 400.Xr rtadvd 8 401and the configuration file 402.Nm 403first appeared in WIDE Hydrangea IPv6 protocol stack kit. 404.\" .Sh BUGS 405.\" (to be written) 406