PIM6SD.CONF(5) BSD File Formats Manual PIM6SD.CONF(5)NAMEpim6sd.conf — config file for pim6sd, PIM-SM daemon for IPv6
DESCRIPTION
The pim6sd.conf 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.
Each statement can be constructed by multiple lines.
Lines beginning with ‘#’ are comments.
The following statements can be specified in the configuration file.
log option... ;
Specify debug messages to be printed out. Each option usually
specifies a subset of the messages to be printed. If an option
begins with no, it means that the set of the messages that are
specified by the option will not be printed. For example, `all
nomld' means that all the messages except MLD related ones will
be printed. Valid options are mld_proto, mld_timer, mld_member,
mld, switch, trace, mtrace, traceroute, timeout, callout, pkt,
packets, interfaces, vif, kernel, cache, mfc, k_cache, k_mfc,
rsrr, pim_detail, pim_hello, pim_neighbors, pim_register,
registers, pim_join_prune, pim_j_p, pim_jp, pim_bootstrap,
pim_bsr, bsr, bootstrap, pim_asserts, pim_cand_rp, pim_c_rp,
pim_rp, rp, pim_routes, pim_routing, pim_mrt, pim_timers,
pim_rpf, rpf, pim, routes, routing, mrt, routers, mrouters,
neighbors, timers, asserts, and all.
reverselookup (yes | no);
Specifies if a hostname for an IPv6 address should be resolved on
logging. yes means a hostname should be resolved, and no means
should not. By default, a hostname is not resolved.
default_phyint_status (disable | enable);
Specifies pim6sd(8) to enable or disable multicast routing, when
it is not explicitly configured in phyint statement. By default,
enable is assumed.
phyint interface (disable | enable);
Specifies pim6sd(8) to enable or disable multicast routing on the
interface. If none of them are specified, default_phyint_status
statement determines whether multicast routing is enabled or dis‐
abled. Interfaces are specified in the form of "name unit", such
as gif0 and ep1.
phyint interface [preference preference] [metric metric] ;
Specifies the preference and/or metric values when sending a PIM
assert message on the interface.
phyint interface [priority priority] ;
Specifies the DR-priority value when sending a PIM hello message
on the interface. If not specified, the DR-priority value is set
to 1.
phyint interface [nolistener] ;
Stops the advertisement of MLD packets on the interface. This
option is usually meaningless but will be useful when MLD mes‐
sages are noisy (e.g. when debugging) and there is surely no lis‐
tener on the interface.
phyint interface [llqi n] [robustness r] [query_rsp_interval qri]
[query_interval qi] [mld_version ver] ;
Specifies MLDv2-specific parameters for the given interface.
llqi is used to specify last-listener-query-interval, and its
default value is 1000ms. robustness is for robustness-variable
for the interface and its default value is 2. query_rsp_interval
and query_interval corresponds to query-response-interval and
query-interval in MLDv2 Query message, and their default value is
10000ms (query_rsp_interval), and 125s (query_interval).
mld_version is used to specify the acceptable version of MLD.
For example if it is configured as 1, then only MLDv1 packet is
permitted on this interface. If the argument is any , then any
version of MLD (currently v1 and v2) are permitted. If you are
to enable MLDv1-compat-mode under MLDv2, you should specify any ,
since only MLDv2 packet is permitted if it is configured as 2.
Its default value is 1.
default_source_preference preference;
Specifies a default preference value when sending a PIM assert
message. Preferences are used by assert elections to determine
upstream routers. Currently pim6sd(8) does not have an effective
method to obtain preferences and metrics from the unicast routing
protocols, so you may want to set a default value by hand. The
default preference is 1024.
default_source_metric metric;
Specifies a default metric value when sending a PIM assert mes‐
sage. Since pim6sd(8) cannot get an effective metric of unicast
routing, it is recommended that preferences is set such that met‐
rics are never consulted. However, default metrics may also be
set, and its default value is 1024.
granularity second;
Specifies timer granularity in seconds. The default value is 5.
hello_period period coef;
Period specifies the period in second between 2 hello messages.
Coef is the coefficient to determine the hello holdtime; the
holdtime will be period * 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.
join_prune_period period coef;
Period specifies the period in second between 2 join/prune mes‐
sages. Coef is the coefficient to determine the join/prune hold‐
time; the holdtime will be period * coef. The default values of
the period and the coefficient are 60 and 3.5, respectively. Con‐
sequently, the default holdtime is 210 seconds.
data_timeout timer;
Specifies the time after which (S,G) state for a silent source
will be deleted. The default value is 210.
register_suppression_timeout interval;
Interval specifies the interval between receiving a Register-Stop
and allowing PIM Register to be send again. The default value is
60.
probe_time timer;
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.
assert_timeout interval;
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.
cand_rp [interface] [time time] [priority priority] ;
Specifies to act as a Candidate Rendezvous Point(RP). It is rec‐
ommended to specify cand_rp only in typical usage. All other
parameters are optional and will be set automatically. If an
interface is specified, pim6sd(8) will search for a global
address on the specified interface and set the address in Candi‐
date RP Advertisements. An optional parameter time specifies the
interval of two succeeding advertisements in seconds. Its
default value is 60. 2.5 * time will be set to Candidate-RP-
Advertisement messages. Another optional parameter priority
specifies the priority of the RP. The default value is 0, which
means the highest priority.
static prefix address ;
Specifics a static route only for RPF calculation.
static_rp prefix address [priority priority] ;
Specifies a static group-to-RP mapping. Necessary when there is
a IPv6 multicast router not understanding BSR message. It cannot
be specified with cand_rp or cand_bsr configuration.
BSR function remains working independly of this option, so you
can specify static group-to-RP mappings by this option while
flodding BSR messages from upstream to downstreams, but cannot
redistribute this static mapping by BSR messages.
If this option and BSR message provides a different RP for the
same group, the one with higher priority (i.e. smaller priority
value) is chosen. If their priority is same, static one wins.
An optional parameter priority specifies the priority of this
static group-to-RP mapping. Its default value is 0 (highest).
group_prefix prefix;
When acting as a Rendezvous Point(RP), prefix specifies a group
prefix that the RP will handle.
cand_bootstrap_router [interface] [time time] [priority priority]
[masklen masklen] ;
Specifies to act as a Candidate Bootstrap Router(BSR). It is
recommended to specify cand_bootstrap_router only in typical
usage. All other parameters are optional and will be set auto‐
matically. If an interface is specified, pim6sd(8) will search
for a global address on the specified interface and set the
address in Bootstrap messages. An optional parameter time speci‐
fies the interval of two succeeding bootstraps in seconds. Its
default value is 60. Another optional parameter priority speci‐
fies the priority of the BSR. The default value is 0, which
means the lowest priority. Hash mask length can also be speci‐
fied by the masklen parameter. Its value, masklen, must be no
less than 0 and no greater than 128.
switch_register_threshold rate rate interval interval;
Specifies the threshold that a Rendezvous Point(RP) switches to a
shortest path tree, which is valid only when acting as an RP.
rate specifies the threshold in bits per second, and interval
specifies the interval of checking the rate in seconds. The
default values are 50000 and 20, respectively.
switch_data_threshold rate rate interval interval;
Specifies the threshold that a last hop router switches to a
shortest path tree. rate specifies the threshold in bits per
second, and interval specifies the interval of checking the rate
in seconds. The default values are 50000 and 20, respectively.
EXAMPLE
# 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;
SEE ALSOpim6sd(8)HISTORY
The pim6sd(8) command is developed by Mickael Hoerdt at LSIIT Laboratory.
It is based on IPv4 PIM sparse-mode pimd developed at University of
Southern California, which has also been derived from mrouted. mrouted
is COPYRIGHT 1989 by The Board of Trustees of Leland Stanford Junior Uni‐
versity.
BUGS
static_rp configuration does not work at RP. So please use 'cand_rp'
command at RP until this bug is fixed.
KAME Oct 6, 1999 KAME
