PIM6SD.CONF(5) BSD Programmer's 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.
phyint interface [disable] ;
Specifies pim6sd(8) to ignore the interface even if the interface
is multicast-capable. Note that PIM will be activated on all in-
terfaces by default. Interfaces are specified in the form of
"name unit", such as gif0 and ep1.
phyint interface [preference preference] [metric metric] [nolistener] ;
Specifies the preference and/or metric values when sending a PIM
assert message on the interface. If another optional parameter
nolistener is specified, pim6sd(8) 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.
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 re-
ceiving 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 de-
fault 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 pa-
rameters are optional and will be set automatically. If an
interface is specified, pim6sd(8) will search for a global ad-
dress on the specified interface and set the address in Candidate
RP Advertisements. An optional parameter time specifies the in-
terval of two succeeding advertisements in seconds. Its default
value is 60. 2.5 * time will be set to Candidate-RP-Advertise-
ment messages. Another optional parameter priority specifies the
priority of the RP. The default value is 0, which means the
highest priority.
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 us-
age. All other parameters are optional and will be set automati-
cally. 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 specifies the in-
terval of two succeeding bootstraps in seconds. Its default val-
ue is 60. Another optional parameter priority specifies the pri-
ority of the BSR. The default value is 0, which means the lowest
priority. Hash mask length can also be specified by the masklen
parametr. 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 de-
fault 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 Univer-
sity.
KAME Oct 6, 1999 3