dbeacon - Distributed IPv4/IPv6 multicast beacon
Contents
Bugs
Should be reported to the core developer Hugo Santos <hugo@fivebits.net>.
Description
dbeacon is a network level management tool aiming at getting various statistics about multicast
connectivity. Its first usage is to check out if you can send/receive toward/from an IPv4/IPv6 multicast
network. Its second usage is to gather various statistics by using a known multicast ASM group, for
example TTL between each multicast peers, loss or jitter figures. Theses statistics are kept internally
but can be dumped periodically in a file in xml format for latter processing. Statistics gathering is
completetly distributed and rely on the powerful nature of ASM. No server is required, but maybe a http
server for accessing the statistics and build an adjacency matrix of the peers.
History
dbeacon is a joint work of Hugo Santos, Sebastien Chaumontet and Mickael Hoerdt. It has been done in the
early days of the m6bone, when nobody knew if the SPTs or RPTs were being used between hosts and also to
evaluate the performance and deployment of SSM.
User Manuals dbeacon(1)
Name
dbeacon - Distributed IPv4/IPv6 multicast beacon
Options
-nNAME, -nameNAME
The name identifying you on the dbeacon session. If not specified, dbeacon will use the hostname
of the running machine.
-aMAIL
Administrative contact. This is an e-mail used for join you, for example to notify you that
something is wrong is your multicast connectivity
-iIN, -interfaceIN
Use IN instead of the default interface for multicast.
-bBEACON_ADDR/PORT
This is the IPv4/IPv6 address of the ASM group used by dbeacon to gather statistics. It can be
specified as a DNS name too.
-SGROUP_ADDR/PORT
Enables SSM reception/sending on optional GROUP_ADDR/PORT
-O This option enable SSM data sending in addition to ASM data. It can be used to check if people can
reach you via SSM.
-BADDR
This allows you to bootstrap from an ADDR that is already in the matrix. This option is useful
when you ASM connectivity is broken but SSM connectivity works.
-P, -ssmping
Enable SSM Ping server capability.
-sADDR
Bind to local address. This allow you to specify the multicast source of the packets sent by your
beacon.
-dFILE
Dump periodic reports to dump.xml or specified file. This file may be latter processed by any XML
compliant script. On a http server, you can process the dump to create a nice adjacency matrix.
-INUMBER, -intervalNUMBER
Interval between refresh of the dump file. Defaults to 5 secs if not specified
-WURL, -websiteURL
Specify a website to announce.
-WmURL, -matrixURL
Specify your matrix URL.
-WlURL, -lgURL
Specify your looking glass URL.
-CCC Specify your two letter Country Code.
-Lprogram
Launch program after each dump. The first argument will be the dump filename.
-Fflag
Specify a flag to announce. For example to announce that your host is running a ssmpingd deamon,
use 'ssmping' as a flag.
-4, -ipv4
Force IPv4 usage (Default is IPv6).
-6, -ipv6
Force IPv6 usage
-v verbose mode (use several for more verbosity)
-U Dump periodic bandwidth usage reports to stdout
-D, -daemon
fork to the background (daemonize)
-pidfileFILE
Path to the PID file to write to.
-syslog
Outputs using syslog facility.
-cFILE
Specifies the configuration file to use. Each of the above command-line parameters can be defined
there.
-V, -version
Outputs version information and leaves
Synopsys
dbeacon-aMAIL-bBEACON_ADDR[/PORT] [-iINTFNAME] [-nNAME] [-S [GROUP_ADDR[/PORT]] [-sADDR] [-d
[FILE]] [-INUMBER] [-Wtype$url] [-Lprogram] [-CCC] [-4] [-6] [-v] [-P] [-U] [-V] [-Fflag] [-O] [-BADDR]
