dvmrpd.conf(5) - OpenBSD manual pages

NAME

dvmrpd.conf — DVMRP routing daemon configuration file

DESCRIPTION

The dvmrpd(8) daemon implements the Distance Vector Multicast Routing Protocol as described in draft-ietf-idmr-dvmrp-v3-11 DVMRP Version 3.

The dvmrpd.conf config file is divided into the following main sections:

Macros: User-defined variables may be defined and used later, simplifying the configuration file.
Global Configuration: Global settings for dvmrpd(8). A number of global settings can be overruled in specific areas or interfaces.
Groups: Groups are used to group similar interfaces, simplifying configuration.

Macros can be defined that will later be expanded in context. Macro names must start with a letter, digit, or underscore, and may contain any of those characters. Macro names may not be reserved words (for example, area, interface, or hello-interval). Macros are not expanded inside quotes.

For example:

hi="60"
group {
	interface em0 {
		query-interval $hi
	}
}

The same can be accomplished by specifying the query-interval globally or within the group declaration.

GLOBAL CONFIGURATION

All interface related settings can be configured globally, per group and per interface. The only settings that can be set globally and not overruled are listed below.

mfc-update (yes|no): If set to yes, the kernel Multicast Forwarding Cache is updated with information from the daemon. The default is yes.

GROUPS

Groups can be used to easily configure similar interfaces. All interface-specific parameters can be configured per group, overruling the global settings.

group

Specify a group section, grouping one or more interfaces.

group {
	robustness 4

	interface em0
	interface em1
}

INTERFACES

Each interface can have several parameters configured individually, otherwise they are inherited.

interface em0 {
}

Interface-specific parameters are listed below.

igmp-version number: Do not use a newer version than specified. Valid range 1–2. The default version used is 2.
last-member-query-count count: The default value is equal to the default robustness variable; valid range is 1–255.
last-member-query-interval seconds: The default value is 10; valid range is 1–65535.
metric cost: Set the interface metric a.k.a. cost. The default value is 1; valid range is 1–31.
passive: Prevent transmission and reception of IGMP and DVMRP packets on this interface.
query-interval seconds: Set the query interval. The default value is 125 seconds; valid range is 1–65535 seconds.
query-response-interval seconds: Set the query-response-interval; note that this must be less than the query-interval. The default value is 100 seconds; valid range is 1–65535 seconds.
robustness factor: Set the robustness factor; note that this value might have an impact on other variables. The default value is 2; valid range is 1–4.
startup-query-count count: Set the startup-query-interval, used during startup to speed up the process of building the IGMP table for an interface. The default value is equal to the default robustness variable; valid range is the same as the robustness variable.
startup-query-interval seconds: Used during startup, see the startup-query-interval. The default value is query-interval / 4; valid range is the same as the query-interval.

FILES

/etc/dvmrpd.conf: dvmrpd(8) configuration file.
/etc/examples/dvmrpd.conf: Example configuration file.

HISTORY

The dvmrpd.conf file format first appeared in OpenBSD 4.0.

OpenBSD manual page server