DVMRPD.CONF(5)

NAME
dvmrpd.conf - Distance Vector Multicast Routing Protocol 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
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.

SEE ALSO
dvmrpctl(8), dvmrpd(8), rc.conf.local(8) draft-ietf-idmr-dvmrp-v3-11, DVMRP Version 3, August 2000.

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