256 lines
5.6 KiB
Groff
256 lines
5.6 KiB
Groff
.\" $NetBSD: route6d.8,v 1.13 2006/05/25 02:21:59 rpaulo Exp $
|
|
.\" $KAME: route6d.8,v 1.11 2002/06/02 15:00:30 itojun Exp $
|
|
.\"
|
|
.\" Copyright (c) 1996 WIDE Project. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modifications, are permitted provided that the above copyright notice
|
|
.\" and this paragraph are duplicated in all such forms and that any
|
|
.\" documentation, advertising materials, and other materials related to
|
|
.\" such distribution and use acknowledge that the software was developed
|
|
.\" by the WIDE Project, Japan. The name of the Project may not be used to
|
|
.\" endorse or promote products derived from this software without
|
|
.\" specific prior written permission. THIS SOFTWARE IS PROVIDED ``AS IS''
|
|
.\" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT
|
|
.\" LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
.\" A PARTICULAR PURPOSE.
|
|
.Dd May 25, 2006
|
|
.Dt ROUTE6D 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm route6d
|
|
.Nd RIP6 routing daemon
|
|
.Sh SYNOPSIS
|
|
.Nm route6d
|
|
.Op Fl adDhlnqsS
|
|
.Bk -words
|
|
.Op Fl R Ar routelog
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl A Ar prefix/preflen,if1[,if2...]
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl L Ar prefix/preflen,if1[,if2...]
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl N Ar if1[,if2...]
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl O Ar prefix/preflen,if1[,if2...]
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl T Ar if1[,if2...]
|
|
.Ek
|
|
.Bk -words
|
|
.Op Fl t Ar tag
|
|
.Ek
|
|
.\"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
is a routing daemon which supports RIP over IPv6.
|
|
.Pp
|
|
Options are:
|
|
.Bl -tag -width indent
|
|
.\"
|
|
.It Fl a
|
|
Enables aging of the statically defined routes.
|
|
With this option, any
|
|
statically defined routes will be removed unless corresponding updates
|
|
arrive as if the routes are received at the startup of
|
|
.Nm .
|
|
.\"
|
|
.It Fl R Ar routelog
|
|
This option makes
|
|
.Nm
|
|
log route changes (add/delete) to the file
|
|
.Ar routelog .
|
|
.\"
|
|
.It Fl A Ar prefix/preflen,if1[,if2...]
|
|
This option is used for aggregating routes.
|
|
.Ar prefix/preflen
|
|
specifies the prefix and the prefix length of the
|
|
aggregated route.
|
|
When advertising routes,
|
|
.Nm
|
|
filters specific routes covered by the aggregate
|
|
and advertises the aggregated route
|
|
.Ar prefix/preflen
|
|
to the interfaces specified in the comma-separated interface list
|
|
.Ar if1[,if2...] .
|
|
.Nm
|
|
creates a static route to
|
|
.Ar prefix/preflen ,
|
|
with the
|
|
.Dv RTF_REJECT
|
|
flag set, into the kernel routing table.
|
|
.\"
|
|
.It Fl d
|
|
Enables output of debugging messages.
|
|
This option also instructs
|
|
.Nm
|
|
to run in foreground mode
|
|
.Pq i.e., it does not become a daemon process .
|
|
.\"
|
|
.It Fl D
|
|
Enables extensive output of debugging messages.
|
|
This option also instructs
|
|
.Nm
|
|
to run in foreground mode
|
|
.Pq i.e., it does not become a daemon process .
|
|
.\"
|
|
.It Fl h
|
|
Disables split horizon processing.
|
|
.\"
|
|
.It Fl l
|
|
By default,
|
|
.Nm
|
|
will not exchange site local routes for safety reasons.
|
|
This is because the semantics of site local address space are rather vague,
|
|
as the specification is still being worked on,
|
|
and there is no good way to define the site local boundary.
|
|
With
|
|
.Fl l ,
|
|
.Nm
|
|
will exchange site local routes as well.
|
|
It must not be used on site boundary routers,
|
|
since
|
|
.Fl l
|
|
assumes that all interfaces are in the same site.
|
|
.\"
|
|
.It Fl L Ar prefix/preflen,if1[,if2...]
|
|
Filter incoming routes from interfaces
|
|
.Ar if1,[if2...] .
|
|
.Nm
|
|
will accept incoming routes that are in
|
|
.Ar prefix/preflen .
|
|
If multiple
|
|
.Fl L
|
|
options are specified, all routes that match any of the options are accepted.
|
|
.Li ::/0
|
|
is treated specially as default route, not
|
|
.Do
|
|
any route that has longer prefix length than, or equal to 0
|
|
.Dc .
|
|
If you would like to accept any route, specify no
|
|
.Fl L
|
|
option.
|
|
For example, with
|
|
.Do
|
|
.Fl L
|
|
.Li 3ffe::/16,if1
|
|
.Fl L
|
|
.Li ::/0,if1
|
|
.Dc
|
|
.Nm
|
|
will accept the default route and routes in the 6bone test address range,
|
|
but no others.
|
|
.\"
|
|
.It Fl n
|
|
Do not update the kernel routing table.
|
|
.\"
|
|
.It Fl N Ar if1[,if2...]
|
|
Do not listen to, or advertise, route from/to interfaces specified by
|
|
.Ar if1,[if2...] .
|
|
.\"
|
|
.It Fl O Ar prefix/preflen,if1[,if2...]
|
|
Restrict route advertisement toward interfaces specified by
|
|
.Ar if1,[if2...] .
|
|
With this option
|
|
.Nm
|
|
will only advertise routes that match
|
|
.Ar prefix/preflen .
|
|
.\"
|
|
.It Fl q
|
|
Makes
|
|
.Nm
|
|
use listen-only mode.
|
|
No advertisement is sent.
|
|
.\"
|
|
.It Fl s
|
|
Makes
|
|
.Nm
|
|
advertise the statically defined routes which exist in the kernel routing
|
|
table when
|
|
.Nm
|
|
is invoked.
|
|
Announcements obey the regular split horizon rule.
|
|
.\"
|
|
.It Fl S
|
|
This option is the same as
|
|
.Fl s ,
|
|
except that the split horizon rule does apply.
|
|
.\"
|
|
.It Fl T Ar if1[,if2...]
|
|
Advertise only the default route toward
|
|
.Ar if1,[if2...] .
|
|
.\"
|
|
.It Fl t Ar tag
|
|
Attach the route tag
|
|
.Ar tag
|
|
to originated route entries.
|
|
.Ar tag
|
|
can be decimal, octal prefixed by
|
|
.Li 0 ,
|
|
or hexadecimal prefixed by
|
|
.Li 0x .
|
|
.\"
|
|
.El
|
|
.Pp
|
|
Upon receipt of signal
|
|
.Dv SIGINT
|
|
or
|
|
.Dv SIGUSR1 ,
|
|
.Nm
|
|
will dump the current internal state into
|
|
.Pa /var/run/route6d_dump .
|
|
.\"
|
|
.Sh FILES
|
|
.Bl -tag -width /var/run/route6d_dump -compact
|
|
.It Pa /var/run/route6d_dump
|
|
contains the internal state dumps created if
|
|
.Nm
|
|
receives a
|
|
.Dv SIGINT
|
|
or
|
|
.Dv SIGUSR1
|
|
signal
|
|
.El
|
|
.\"
|
|
.Sh SEE ALSO
|
|
.Rs
|
|
.%A G. Malkin
|
|
.%A R. Minnear
|
|
.%T RIPng for IPv6
|
|
.%R RFC 2080
|
|
.%D January 1997
|
|
.Re
|
|
.\"
|
|
.Sh NOTES
|
|
.Nm
|
|
uses the advanced IPv6 API,
|
|
defined in RFC 3542,
|
|
for communicating with peers using link-local addresses.
|
|
.Pp
|
|
Internally
|
|
.Nm
|
|
embeds interface identifiers into bits 32 to 63 of link-local addresses
|
|
.Po
|
|
.Li fe80::xx
|
|
and
|
|
.Li ff02::xx
|
|
.Pc
|
|
so they will be visible in the internal state dump file
|
|
.Pq Pa /var/run/route6d_dump .
|
|
.Pp
|
|
Routing table manipulation differs from IPv6 implementation to implementation.
|
|
Currently
|
|
.Nm
|
|
obeys the WIDE Hydrangea/KAME IPv6 kernel,
|
|
and will not be able to run on other platforms.
|
|
.Pp
|
|
Currently,
|
|
.Nm
|
|
does not reduce the rate of the triggered updates when consecutive updates
|
|
arrive.
|