xref: /openbsd/usr.sbin/dvmrpd/dvmrpd.8 (revision 09467b48)
1.\"	$OpenBSD: dvmrpd.8,v 1.11 2019/11/10 20:51:53 landry Exp $
2.\"
3.\" Copyright (c) 2004, 2005, 2006 Esben Norby <norby@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: November 10 2019 $
18.Dt DVMRPD 8
19.Os
20.Sh NAME
21.Nm dvmrpd
22.Nd Distance Vector Multicast Routing Protocol daemon
23.Sh SYNOPSIS
24.Nm
25.Op Fl dnv
26.Op Fl f Ar file
27.Sh DESCRIPTION
28.Nm
29is the Distance Vector Multicast Routing Protocol
30.Pq DVMRP
31daemon, which manages multicast routing tables.
32This implementation supports DVMRP version 3.255,
33thus it is only capable of maintaining IPv4 multicast routing tables.
34.Pp
35DVMRP uses a distance vector routing algorithm to build
36reverse path multicast delivery trees.
37A flood and prune approach is used to determine which branches in
38the network have multicast listeners.
39The usual drawbacks of a distance vector route protocol applies to DVMRP:
40slow convergence and scalability issues.
41.Pp
42DVMRP routers communicate via the multicast group 224.0.0.4
43All DVMRP Routers.
44IP protocol number 2
45.Pq IGMP
46is used, furthermore DVMRP packets omit the use of TCP and UDP.
47.Pp
48It is possible to interconnect multicast networks with the use of tunnels.
49Tunnels can traverse routers and networks not supporting multicast.
50.Nm
51does not support tunneling as described in RFC 1075,
52since it has been abandoned.
53.Nm
54can tunnel multicast traffic using generic solutions such as
55.Xr gre 4 .
56.Pp
57DVMRP is used for handling multicast routing exclusively.
58It is not required that a unicast routing protocol is used in
59conjunction with DVMRP.
60.Pp
61To have
62.Nm
63enabled at boot time, use
64.Dq rcctl enable dvmrpd ,
65which sets
66.Pp
67.Dl dvmrpd_flags=\(dq\(dq
68.Pp
69in
70.Xr rc.conf.local 8 .
71.Pp
72A running
73.Nm
74can be controlled with the
75.Xr dvmrpctl 8
76utility.
77.Pp
78The options are as follows:
79.Bl -tag -width Ds
80.It Fl d
81Do not daemonize.
82If this option is specified,
83.Nm
84will run in the foreground and log to
85.Em stderr .
86.It Fl f Ar file
87Specify an alternative configuration file.
88.It Fl n
89Configtest mode.
90Only check the configuration file for validity.
91.It Fl v
92Produce more verbose output.
93.El
94.Sh FILES
95.Bl -tag -width "/var/run/dvmrpd.sockXX" -compact
96.It Pa /etc/dvmrpd.conf
97Default
98.Nm
99configuration file.
100.It Pa /var/run/dvmrpd.sock
101.Ux Ns -domain
102socket used for communication with
103.Xr dvmrpctl 8 .
104.El
105.Sh SEE ALSO
106.Xr dvmrpd.conf 5 ,
107.Xr dvmrpctl 8
108.Sh STANDARDS
109.Rs
110.%D August 2000
111.%R draft-ietf-idmr-dvmrp-v3-11
112.%T DVMRP Version 3
113.Re
114.Sh HISTORY
115The
116.Nm
117program first appeared in
118.Ox 4.0 .
119