.\" As its sole author, I explicitly place this file in the public domain.
.\" It may be used by anyone in any way for any purpose, though I would
.\" appreciate credit where it's due.
.\"		der Mouse, mouse@rodents.montreal.qc.ca, 2000-01-26
.Dd August 10, 2000
.Dt NC 1
.Os NetBSD 1.4T
.Sh NAME
.Nm rip6adv
.Nd RIP6 route advertiser
.Sh SYNOPSIS
.Nm
.Op options ...
.Oo Ar src-addr Oc Ns Oo
.Ar / Ns Op Ar src-port
.Oc
.Ar target-addr Ns Op / Ns Op target-port
.Ar route-spec
.Oo
.Ar route-spec ...
.Oc
.Sh DESCRIPTION
.Nm
is a small tool designed for advertising IPv6 routes with RIPng (see
RFC 2080).  The available
.Ar options
are as follows.  If conflicting options are given, the last one
specified wins.
.Bl -tag -width indent
.It Fl a
Turn on
.Dv SO_REUSEADDR
on the sending socket (see
.Xr setsockopt 2 ) .
.It Fl p
Turn on
.Dv SO_REUSEPORT
on the sending socket (see
.Xr setsockopt 2 ) .
.El
.Pp
Packets are sent from the specified
.Ar src-addr ,
port
.Ar src-port
if specified (by default, port 521; if the sending port doesn't matter,
specify 0 and the kernel will pick one).  They are sent to
.Ar target-addr ,
port
.Ar target-port
if specified (otherwise the default RIPng port, port 521).  Further
arguments specify routes to be advertised.
.Pp
Each
.Ar route-spec
consists of a destination, followed by additional specifiers describing
the other information necessary.  The destination argument consists of
a numeric IPv6 address followed by a slash and a prefix width.  Each
additional specifier consists of a keyword followed by a value.
Optionally, the destination argument may be preceded by the keyword
.Sq to .
.Pp
The additional specifier keywords available are:
.Bl -tag -width indent
.It via
Specifies the next-hop gateway.  The next argument must be a numeric
address.  If this is omitted, the same value is used as for the
previous route; if there is no previous next-hop specifier, no next-hop
spec is put into the packet, which tells RIPng listeners to use the
address the packet came from.  Specifying :: as the next-hop gateway
restores the default of using the address the packet came from after an
earlier specification of a non-default value.
.It metric
Specifies the route's metric.  The next argument must be a small
integer (in the range 1 through 16, 16 representing
.Sq unreachable ) .
If this is omitted, the default is 1.
.It tag
Specifies the route tag.  The next argument must be a small integer (in
the range 0 through 65535).  If this is omitted, the default is 0.  (If
you don't know what route tags are, you can almost certainly just skip
this specifier.)
.El
.Pp
.Ar target-addr
will normally be the all-RIPng-routers address for some
directly-connected network (eg, ff02::9%ex0), but this does not have to
be the case.
.Pp
.Ar src-addr
must normally be a link-local unicast address on the sending interface.
For convenience, if a zero-length string is given for src-addr, and the
target-addr includes an interface name marked with a percent sign,
.Nm
will try to find a link-local unicast address on the specified
interface and use that.  (If it fails, it will complain and refuse to
run.)  XXX This convenience feature is not actually implemented yet!
.Pp
The entire argument list is always sent as a single packet.  If you
want to advertise so many routes that you need multiple packets, run
multiple instances of
.Nm rip6adv .
.Pp
Packets are emitted every 30 seconds.
.Sh EXAMPLES
.D1 rip6adv / ff02::9%le0 ::/0 metric 2 3ffe:1234:5678::9:0/112
.Sh AUTHOR
der Mouse,
.Aq mouse@rodents.montreal.qc.ca .