mirror of
https://git.FreeBSD.org/src.git
synced 2025-01-01 12:19:28 +00:00
0fea3d5165
kernel IPv6 multicast routing support. pim6 dense mode daemon pim6 sparse mode daemon netstat support of IPv6 multicast routing statistics Merging to the current and testing with other existing multicast routers is done by Tatsuya Jinmei <jinmei@kame.net>, who writes and maintainances the base code in KAME distribution. Make world check and kernel build check was also successful.
331 lines
9.5 KiB
Groff
331 lines
9.5 KiB
Groff
.\" Copyright (C) 1999 WIDE Project.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. Neither the name of the project nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" $Id: pim6sd.conf.5,v 1.7 1999/12/03 07:31:45 jinmei Exp $
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd Oct 6, 1999
|
|
.Dt PIM6SD.CONF 5
|
|
.Os KAME
|
|
.Sh NAME
|
|
.Nm pim6sd.conf
|
|
.Nd config file for pim6sd, PIM-SM daemon for IPv6
|
|
.\"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm pim6sd
|
|
configuration file consists of a sequence of statements terminated
|
|
by a semi-colon (`;'), each of which specifies how the daemon treats
|
|
each interface on the system, specifies some parameters of the PIM
|
|
protocol, and requires some special behavior defined by the protocol.
|
|
.Pp
|
|
Each statement can be constructed by multiple lines.
|
|
.Pp
|
|
Lines beginning with
|
|
.Ql #
|
|
are comments.
|
|
.\".Pp
|
|
.\"Note that
|
|
.\".Nm pim6sd
|
|
.\"works even without the configuration file, although the daemon
|
|
.\"will warn that there is no configuration file.
|
|
.\"In such a case, the daemon will automatically set the default value
|
|
.\"to each configurable parameter.
|
|
.\"
|
|
.Pp
|
|
The following statements can be specified in the configuration file.
|
|
.Pp
|
|
.Bl -tag -width Ds -compact
|
|
.It Xo
|
|
.Ic log
|
|
.Ar option...
|
|
.Ic ;
|
|
.Xc
|
|
Specify debug messages to be printed out. Each
|
|
.Ar option
|
|
usually specifies a subset of the messages to be printed.
|
|
If an
|
|
.Ar option
|
|
begins with
|
|
.Ic no ,
|
|
it means that the set of the messages that are specified by the option
|
|
will not be printed. For example,
|
|
.Ic `all nomld'
|
|
means that all the messages except MLD related ones will be printed.
|
|
Valid options are
|
|
.Ic mld_proto, mld_timer, mld_member, mld, switch, trace, mtrace, traceroute,
|
|
.Ic timeout, callout, pkt, packets, interfaces, vif, kernel, cache, mfc,
|
|
.Ic k_cache, k_mfc, rsrr, pim_detail, pim_hello, pim_neighbors, pim_register,
|
|
.Ic registers, pim_join_prune, pim_j_p, pim_jp, pim_bootstrap, pim_bsr, bsr,
|
|
.Ic bootstrap, pim_asserts, pim_cand_rp, pim_c_rp, pim_rp, rp, pim_routes,
|
|
.Ic pim_routing, pim_mrt, pim_timers, pim_rpf, rpf, pim, routes, routing,
|
|
.Ic mrt, routers, mrouters, neighbors, timers, asserts,
|
|
and
|
|
.Ic all .
|
|
.\"
|
|
.It Xo
|
|
.Ic reverselookup (yes \(ba no);
|
|
.Xc
|
|
Specifies if a hostname for an IPv6 address should be resolved
|
|
on logging.
|
|
.Ic yes
|
|
means a hostname should be resolved, and
|
|
.Ic no
|
|
means should not.
|
|
By default, a hostname is not resolved.
|
|
.\"
|
|
.It Xo
|
|
.Ic phyint Ar interface
|
|
.Op disable
|
|
.Ic ;
|
|
.Xc
|
|
Specifies
|
|
.Nm
|
|
to ignore the interface even if the interface is multicast-capable.
|
|
Note that PIM will be activated on all interfaces by default(including
|
|
the case where there is no configuration file).
|
|
Interfaces are specified in the form of "name unit", such as
|
|
.Ar gif0
|
|
and
|
|
.Ar ep1.
|
|
.\"
|
|
.It Xo
|
|
.Ic phyint Ar interface
|
|
.Op preference Ar preference
|
|
.Op metric Ar metric
|
|
.Op nolistener
|
|
.Ic ;
|
|
.Xc
|
|
Specifies the preference and/or metric values when sending a PIM
|
|
assert message on the interface.
|
|
If another optional parameter
|
|
.Ic nolistener
|
|
is specified,
|
|
.Nm pim6sd
|
|
will not send any MLD packets on the interface.
|
|
This option is usually meaningless but will be useful when
|
|
MLD messages are noisy (e.g. when debugging) and there is surely no
|
|
listner on the interface.
|
|
.\"
|
|
.It Xo
|
|
.Ic default_source_preference Ar preference;
|
|
.Xc
|
|
Specifies a default preference value when sending a PIM assert message.
|
|
Preferences are used by assert elections to determine upstream routers.
|
|
Currently
|
|
.Nm pim6sd
|
|
cannot reliably obtain preferences and metrics from the
|
|
unicast routing protocols, so a default value may be configured.
|
|
The default preference is 1024.
|
|
.\"
|
|
.It Ic default_source_metric Ar metric;
|
|
Specifies a default metric value when sending a PIM assert message.
|
|
It is recommended that preferences be set such that metrics are never
|
|
consulted. However, default metrics may also be set and will default to
|
|
1024.
|
|
.\"
|
|
.It Xo
|
|
.Ic granularity Ar second;
|
|
.Xc
|
|
Specifies timer granularity in seconds.
|
|
The default value is 5.
|
|
.\"
|
|
.It Xo
|
|
.Ic hello_period Ar period Ar coef;
|
|
.Xc
|
|
.Ar Period
|
|
specifies the period in second between 2 hello messages.
|
|
.Ar Coef
|
|
is the coefficient to determine the hello holdtime;
|
|
the holdtime will be
|
|
.Ar period
|
|
*
|
|
.Ar coef .
|
|
The default values of the period and the coefficient are 30 and 3.5,
|
|
respectively. The default holdtime is 105 seconds as a result.
|
|
.\"
|
|
.It Xo
|
|
.Ic join_prune_period Ar period Ar coef;
|
|
.Xc
|
|
.Ar Period
|
|
specifies the period in second between 2 join/prune messages.
|
|
.Ar Coef
|
|
is the coefficient to determine the join/prune holdtime;
|
|
the holdtime will be
|
|
.Ar period
|
|
*
|
|
.Ar coef .
|
|
The default values of the period and the coefficient are 60 and 3.5,
|
|
respectively. Consequently, the default holdtime is 210 seconds.
|
|
.\"
|
|
.It Xo
|
|
.Ic data_timeout Ar timer;
|
|
.Xc
|
|
Specifies the time after which (S,G) state for a silent source will be
|
|
deleted.
|
|
The default value is 210.
|
|
.\"
|
|
.It Xo
|
|
.Ic register_suppression_timeout Ar interval;
|
|
.Xc
|
|
.Ar Interval
|
|
specifies the interval between receiving a Register-Stop and allowing
|
|
PIM Register to be send again.
|
|
The default value is 60.
|
|
.\"
|
|
.It Xo
|
|
.Ic probe_time Ar timer;
|
|
.Xc
|
|
.Ar Timer
|
|
specifies the time between sending a null Register and the
|
|
Register-Suppression-Timer expiring unless it is restarted by
|
|
receiving a Register-Stop.
|
|
The default value is 5.
|
|
.\"
|
|
.It Xo
|
|
.Ic assert_timeout Ar interval;
|
|
.Xc
|
|
.Ar Interval
|
|
specifies the interval between the last time an Assert is received and
|
|
the time at which the assert is timeout.
|
|
The default value is 180.
|
|
.\"
|
|
.It Xo
|
|
.Ic cand_rp
|
|
.Op Ar interface
|
|
.Op Ic time Ar time
|
|
.Op Ic priority Ar priority
|
|
.Ic ;
|
|
.Xc
|
|
Specifies to act as a candidate Rendezvous Point(RP).
|
|
It is recommended to specify
|
|
.Ic cand_rp
|
|
only in typical usage.
|
|
All other parameters are optional and will be set automatically.
|
|
If an
|
|
.Ar interface
|
|
is specified,
|
|
.Nm pim6sd
|
|
will search for a global address on the specified interface
|
|
and set the address in Candidate RP Advertisements.
|
|
An optional parameter
|
|
.Ic time
|
|
specifies the interval of two succeeding advertisements in seconds.
|
|
Its default value is 60.
|
|
2.5 *
|
|
.Ar time
|
|
will be set to Candidate-RP-Advertisement messages.
|
|
Another optional parameter
|
|
.Ic priority
|
|
specifies the priority of the RP.
|
|
The default value is 0, which means the highest priority.
|
|
.\"
|
|
.It Xo
|
|
.Ic group_prefix Ar prefix;
|
|
.Xc
|
|
When acting as a Rendezvous Point(RP),
|
|
.Ar prefix
|
|
specifies a group prefix that the RP will handle.
|
|
.\"
|
|
.It Xo
|
|
.Ic cand_bootstrap_router
|
|
.Op Ar interface
|
|
.Op Ic time Ar time
|
|
.Op Ic priority Ar priority
|
|
.Ic ;
|
|
.Xc
|
|
Specifies to act as a candidate bootstrap router(BSR).
|
|
It is recommended to specify
|
|
.Ic cand_bootstrap_router
|
|
only in typical usage.
|
|
All other parameters are optional and will be set automatically.
|
|
If an
|
|
.Ar interface
|
|
is specified,
|
|
.Nm pim6sd
|
|
will search for a global address on the specified interface
|
|
and set the address in Bootstrap messages.
|
|
An optional parameter
|
|
.Ic time
|
|
specifies the interval of two succeeding bootstraps in seconds.
|
|
Its default value is 60.
|
|
Another optional parameter
|
|
.Ic priority
|
|
specifies the priority of the RP.
|
|
The default value is 0, which means the lowest priority.
|
|
.\"
|
|
.It Xo
|
|
.Ic switch_register_threshold Ic rate Ar rate Ic interval Ar interval;
|
|
.Xc
|
|
Specifies the threshold that a Rendezvous Point(RP) switches to a shortest
|
|
path tree, which is valid only when acting as an RP.
|
|
.Ic rate
|
|
specifies the threshold in bits per second, and
|
|
.Ic interval
|
|
specifies the interval of checking the rate in seconds.
|
|
The default values are 50000 and 20, respectively.
|
|
\"
|
|
.It Xo
|
|
.Ic switch_data_threshold Ic rate Ar rate Ic interval Ar interval;
|
|
.Xc
|
|
Specifies the threshold that a last hop router switches to a shortest
|
|
path tree.
|
|
.Ic rate
|
|
specifies the threshold in bits per second, and
|
|
.Ic interval
|
|
specifies the interval of checking the rate in seconds.
|
|
The default values are 50000 and 20, respectively.
|
|
.El
|
|
.\"
|
|
.Sh EXAMPLE
|
|
.Bd -literal -offset
|
|
#phyint gif0 disable;
|
|
#phyint ep0 preference 101;
|
|
phyint de0 disable;
|
|
#
|
|
#followings are for a candidate Rendezvous Point, which should usually
|
|
#be disabled.
|
|
cand_bootstrap_router;
|
|
cand_rp;
|
|
.Ed
|
|
.Sh SEE ALSO
|
|
.Xr pim6sd 8
|
|
.Sh HISTORY
|
|
The
|
|
.Nm pim6sd
|
|
command is developed by Mickael Hoerdt at LSIIT Laboratory.
|
|
It is based on IPv4 PIM sparse-mode
|
|
.Nm pimd
|
|
developed at University of Southern California,
|
|
which has also been derived from
|
|
.Nm mrouted.
|
|
.Nm Mrouted
|
|
is COPYRIGHT 1989 by The Board of Trustees of
|
|
Leland Stanford Junior University.
|
|
.\" .Sh BUGS
|
|
.\" (to be written)
|