head	1.9;
access;
symbols
	cjep_sun2x:1.9.0.44
	cjep_sun2x-base:1.9
	cjep_staticlib_x-base1:1.9
	cjep_staticlib_x:1.9.0.42
	cjep_staticlib_x-base:1.9
	phil-wifi-20200421:1.9
	phil-wifi-20200411:1.9
	phil-wifi-20200406:1.9
	pgoyette-compat-merge-20190127:1.9
	pgoyette-compat-20190127:1.9
	pgoyette-compat-20190118:1.9
	pgoyette-compat-1226:1.9
	pgoyette-compat-1126:1.9
	pgoyette-compat-1020:1.9
	pgoyette-compat-0930:1.9
	pgoyette-compat-0906:1.9
	pgoyette-compat-0728:1.9
	pgoyette-compat-0625:1.9
	pgoyette-compat-0521:1.9
	pgoyette-compat-0502:1.9
	pgoyette-compat-0422:1.9
	pgoyette-compat-0415:1.9
	pgoyette-compat-0407:1.9
	pgoyette-compat-0330:1.9
	pgoyette-compat-0322:1.9
	pgoyette-compat-0315:1.9
	pgoyette-compat:1.9.0.40
	pgoyette-compat-base:1.9
	perseant-stdc-iso10646:1.9.0.38
	perseant-stdc-iso10646-base:1.9
	prg-localcount2-base3:1.9
	prg-localcount2-base2:1.9
	prg-localcount2-base1:1.9
	prg-localcount2:1.9.0.36
	prg-localcount2-base:1.9
	pgoyette-localcount-20170426:1.9
	bouyer-socketcan-base1:1.9
	pgoyette-localcount-20170320:1.9
	bouyer-socketcan:1.9.0.34
	bouyer-socketcan-base:1.9
	pgoyette-localcount-20170107:1.9
	pgoyette-localcount-20161104:1.9
	localcount-20160914:1.9
	pgoyette-localcount-20160806:1.9
	pgoyette-localcount-20160726:1.9
	pgoyette-localcount:1.9.0.32
	pgoyette-localcount-base:1.9
	netbsd-5-2-3-RELEASE:1.9
	netbsd-5-1-5-RELEASE:1.9
	yamt-pagecache-base9:1.9
	yamt-pagecache-tag8:1.9
	tls-earlyentropy:1.9.0.28
	tls-earlyentropy-base:1.9
	riastradh-xf86-video-intel-2-7-1-pre-2-21-15:1.9
	riastradh-drm2-base3:1.9
	netbsd-5-2-2-RELEASE:1.9
	netbsd-5-1-4-RELEASE:1.9
	netbsd-5-2-1-RELEASE:1.9
	netbsd-5-1-3-RELEASE:1.9
	agc-symver:1.9.0.30
	agc-symver-base:1.9
	tls-maxphys-base:1.9
	yamt-pagecache-base8:1.9
	netbsd-5-2:1.9.0.26
	yamt-pagecache-base7:1.9
	netbsd-5-2-RELEASE:1.9
	netbsd-5-2-RC1:1.9
	yamt-pagecache-base6:1.9
	yamt-pagecache-base5:1.9
	yamt-pagecache-base4:1.9
	netbsd-5-1-2-RELEASE:1.9
	netbsd-5-1-1-RELEASE:1.9
	yamt-pagecache-base3:1.9
	yamt-pagecache-base2:1.9
	yamt-pagecache:1.9.0.24
	yamt-pagecache-base:1.9
	bouyer-quota2-nbase:1.9
	bouyer-quota2:1.9.0.22
	bouyer-quota2-base:1.9
	matt-nb5-pq3:1.9.0.20
	matt-nb5-pq3-base:1.9
	netbsd-5-1:1.9.0.18
	netbsd-5-1-RELEASE:1.9
	netbsd-5-1-RC4:1.9
	netbsd-5-1-RC3:1.9
	netbsd-5-1-RC2:1.9
	netbsd-5-1-RC1:1.9
	netbsd-5-0-2-RELEASE:1.9
	netbsd-5-0-1-RELEASE:1.9
	jym-xensuspend-nbase:1.9
	netbsd-5-0:1.9.0.16
	netbsd-5-0-RELEASE:1.9
	netbsd-5-0-RC4:1.9
	netbsd-5-0-RC3:1.9
	netbsd-5-0-RC2:1.9
	jym-xensuspend:1.9.0.14
	jym-xensuspend-base:1.9
	netbsd-5-0-RC1:1.9
	netbsd-5:1.9.0.12
	netbsd-5-base:1.9
	mjf-devfs2:1.9.0.10
	mjf-devfs2-base:1.9
	yamt-pf42-base4:1.9
	yamt-pf42-base3:1.9
	hpcarm-cleanup-nbase:1.9
	yamt-pf42-base2:1.9
	yamt-pf42:1.9.0.8
	yamt-pf42-base:1.9
	keiichi-mipv6-nbase:1.9
	keiichi-mipv6:1.9.0.6
	keiichi-mipv6-base:1.9
	cube-autoconf:1.9.0.4
	cube-autoconf-base:1.9
	hpcarm-cleanup:1.9.0.2
	hpcarm-cleanup-base:1.9
	netbsd-1-5-PATCH003:1.6.4.1
	netbsd-1-5-PATCH002:1.6.4.1
	netbsd-1-5-PATCH001:1.6.4.1
	netbsd-1-5-RELEASE:1.6
	netbsd-1-5-BETA2:1.6
	netbsd-1-5-BETA:1.6
	netbsd-1-5-ALPHA2:1.6
	netbsd-1-5:1.6.0.4
	netbsd-1-5-base:1.6
	minoura-xpg4dl-base:1.6
	minoura-xpg4dl:1.6.0.2
	wrstuden-devbsize-19991221:1.5
	wrstuden-devbsize:1.4.0.4
	wrstuden-devbsize-base:1.5
	comdex-fall-1999:1.4.0.2
	comdex-fall-1999-base:1.4;
locks; strict;
comment	@.\" @;


1.9
date	2001.06.02.00.34.04;	author itojun;	state dead;
branches;
next	1.8;

1.8
date	2001.04.11.19.26.40;	author wiz;	state Exp;
branches;
next	1.7;

1.7
date	2000.07.10.08.58.32;	author itojun;	state Exp;
branches;
next	1.6;

1.6
date	2000.05.19.10.43.44;	author itojun;	state Exp;
branches
	1.6.4.1;
next	1.5;

1.5
date	99.11.19.01.12.44;	author enami;	state Exp;
branches;
next	1.4;

1.4
date	99.09.12.18.47.12;	author kleink;	state Exp;
branches
	1.4.4.1;
next	1.3;

1.3
date	99.09.03.04.49.24;	author itojun;	state Exp;
branches;
next	1.2;

1.2
date	99.08.19.17.31.07;	author itojun;	state Exp;
branches;
next	1.1;

1.1
date	99.07.17.14.06.25;	author itojun;	state Exp;
branches;
next	;

1.6.4.1
date	2001.06.07.16.44.08;	author he;	state dead;
branches;
next	;

1.4.4.1
date	99.12.27.18.37.57;	author wrstuden;	state Exp;
branches;
next	;


desc
@@


1.9
log
@remove pim6[sd]d from the tree.  the software had a restrictive license
than we can handle.  hope to re-enable it as pkgsrc, or to re-enable it
into basesrc if license updates.
@
text
@.\"	$NetBSD: pim6dd.conf.5,v 1.8 2001/04/11 19:26:40 wiz Exp $
.\"	$KAME: pim6dd.conf.5,v 1.7 2000/07/10 08:56:18 itojun Exp $
.\"
.\" Copyright (C) 1998 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.
.\"
.Dd November 17, 1998
.Dt PIM6DD.CONF 5
.Os
.Sh NAME
.Nm pim6dd.conf
.Nd config file for pim6dd, PIM for IPv6 dense mode daemon
.\"
.Sh DESCRIPTION
The file describes how the
.Xr pim6dd 8
daemon treats each interface on the system.
By default(including the case where there is no configuration file),
PIM will be activated on all interfaces, which can be overridden
by the file.
Lines beginning with
.Ql #
are comments.
.Pp
The following configuration directives are availble:
.Pp
.Bl -tag -width Ds -compact
.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
.Xr pim6dd 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.
.\"
.It Ic default_source_metric Ar metric
Specifies a default metric value when sending a PIM assert message.
Since
.Xr pim6dd 8
cannot get an effective metric of unicast routing,
it is recommended that preferences is set such that metrics are never
consulted. However, default metrics may also be set, and
its default value is 1024.
.\"
.It Xo
.Ic phyint Ar interface
.Op disable
.Xc
Specifies
.Xr pim6dd 8
to ignore the interface even if the interface is multicast-capable.
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
.Xc
Specifies the preference and/or metric values when sending a PIM
assert message on the interface.
.\"
.It Xo
.Ic filter Ar groupaddrs Ar interfaces...
.Xc
Specifies an output filter by defining an administrative scope.
If an incoming multicast packet's destination
matches the specified
.Ar groupaddrs ,
the packet is not sent on the
.Ar interfaces.
Moreover, if there is no other interface than the specified
interfaces,
.Xr pim6dd 8
sends a prune message to the upstream neighbor.
Valid formats of
.Ar groupaddrs
are as follows.
.Bl -tag -width Ds -compact
.It Ar multicastaddr1-multicastaddr2
specifies a numerical range of a scope.
Multicast addresses
from
.Ar multicastaddr1
to
.Ar multicastaddr2
will be filtered out.
Note that neither a white space nor a tab character must not be
inserted before nor after
.Ql - .
.It Ar multicastaddr/prefixlen
specifies a group prefix of a scope.
Multicast addresses which match the specified prefix will be filtered
out.
If
.Ar prefixlen
is omitted, it means the exact match for
.Ar multicastaddr.
.El
.Ar interfaces
are specified as a blank separated list of interfaces. Each interface is
specified in the form of "name unit".
.El
.\"
.Sh EXAMPLE
.Bd -literal -offset
# phyint gif0 disable
# phyint ep0 preference 101
phyint de0 disable
filter ff15::4000/120 gif1 gif2
filter ff18::1000-ff18::1050 gif3
.Ed
.Sh SEE ALSO
.Xr pim6dd 8
.Sh HISTORY
The
.Xr pim6dd 8
command and the configuration file
.Nm
are based on
.Nm pimdd ,
which is an IPv4 multicast routing daemon
developed at the University of Oregon.
.Nm pimdd
has been derived from PIM sparse-mode
.Nm pimd
developed at University of Southern California.
Part of these two programs above has also been derived from
.Nm mrouted .
.Nm mrouted
is COPYRIGHT 1989 by The Board of Trustees of
Leland Stanford Junior University.
@


1.8
log
@Fix date.
@
text
@d1 1
a1 1
.\"	$NetBSD: pim6dd.conf.5,v 1.7 2000/07/10 08:58:32 itojun Exp $
@


1.7
log
@sync with latest kame.  wording and .Nm/.Xr clearifications.
@
text
@d1 1
a1 1
.\"	$NetBSD: pim6dd.conf.5,v 1.6 2000/05/19 10:43:44 itojun Exp $
d31 1
a31 1
.Dd Nov 17, 1998
@


1.6
log
@update IPv6 MLD API to new one.  various corrections including
timeout processing, node-local/link-local handling (ignore them),
and more.  (sync with kame)
nroff fixes to manpage.
@
text
@d1 2
a2 1
.\"	$NetBSD: pim6dd.conf.5,v 1.5 1999/11/19 01:12:44 enami Exp $
a30 2
.\"	KAME Id: pim6dd.conf.5,v 1.3 2000/05/05 14:43:18 sumikawa Exp
.\"
d40 1
a40 1
.Nm pim6dd
d49 2
a50 1
There are four types of configuration commands:
d58 3
a60 3
.Nm
cannot reliably obtain preferences and metrics from the
unicast routing protocols, so a default value may be configured.
d64 6
a69 3
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.
d76 1
a76 1
.Nm
d94 2
a95 1
Specifies an output filter. If an incoming multicast packet's destination
d102 1
a102 1
.Nm pim6dd
d145 1
a145 1
.Nm pim6dd
d152 1
a152 1
.Nm Pimdd
d157 2
a158 2
.Nm mrouted.
.Nm Mrouted
@


1.6.4.1
log
@Pull up file removal (requested by itojun):
  Remove pim6dd and pim6sd due to these programs having a more
  restrictive license than we wish to deal with.  The programs are
  instead available through pkgsrc.
@
text
@d1 1
a1 1
.\"	$NetBSD: pim6dd.conf.5,v 1.6 2000/05/19 10:43:44 itojun Exp $
@


1.5
log
@Don't pass so many args to .Nd macro.  It just overflows.
@
text
@d1 2
d30 1
a30 2
.\"	$NetBSD: pim6dd.conf.5,v 1.4 1999/09/12 18:47:12 kleink Exp $
.\"	KAME Id: pim6dd.conf.5,v 1.1.1.1 1999/08/08 23:30:53 itojun Exp
d32 1
a32 1
.Dd November 17, 1998
d37 1
a37 1
.Nd "config file for pim6dd, PIM for IPv6 dense mode daemon"
d93 1
a93 1
.Ar groupaddrs,
d131 2
a132 2
#phyint gif0 disable
#phyint ep0 preference 101
d145 1
a145 1
.Nm pimdd,
a156 2
.\" .Sh BUGS
.\" (to be written)
@


1.4
log
@Use full month names with .Dd, as per mdoc.samples(7).
@
text
@d28 1
a28 1
.\"	$NetBSD: pim6dd.conf.5,v 1.3 1999/09/03 04:49:24 itojun Exp $
d36 1
a36 1
.Nd config file for pim6dd, PIM for IPv6 dense mode daemon
@


1.4.4.1
log
@Pull up to last week's -current.
@
text
@d28 1
a28 1
.\"	$NetBSD: pim6dd.conf.5,v 1.5 1999/11/19 01:12:44 enami Exp $
d36 1
a36 1
.Nd "config file for pim6dd, PIM for IPv6 dense mode daemon"
@


1.3
log
@sync with recent KAME.
- added more friendly debugging code
- fix to make assert looser correctly stop forwarding
- fixed SIGHUP support
@
text
@d28 1
a28 1
.\"	$NetBSD$
d31 1
a31 1
.Dd Nov 17, 1998
@


1.2
log
@sync with recent KAME code.
- do not use s6_addr{8,16,32}, which are nonstandard.
- SIGHUP handling now works correctly.
@
text
@d28 1
a28 1
.\"	$NetBSD: pim6dd.conf.5,v 1.1 1999/07/17 14:06:25 itojun Exp $
@


1.1
log
@pim6dd: IPv6 PIM (protocol independent multicast),
dense mode routing daemon.
@
text
@d28 2
a29 2
.\"	$NetBSD$
.\"	KAME Id: pim6dd.conf.5,v 1.1.2.3.4.3 1999/07/17 13:47:35 itojun Exp
@