dbeacon1

Synopsys

dbeacon -a MAIL -b BEACON_ADDR[/PORT] [-i INTFNAME] [-n NAME] [-S [GROUP_ADDR[/PORT]] [-s ADDR] [-d [FILE]] [-I NUMBER] [-W type$url] [-L program] [-C CC] [-4] [-6] [-v] [-P] [-U] [-V] [-F flag] [-O] [-B ADDR]

Overview

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.

Options

-n NAME, -name NAME

The name identifying you on the dbeacon session. If not specified, dbeacon will use the hostname of the running machine.

-a MAIL

Administrative contact. This is an e-mail used for join you, for example to notify you that something is wrong is your multicast connectivity

-i IN, -interface IN

Use IN instead of the default interface for multicast.

-b BEACON_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.

-S GROUP_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.

-B ADDR

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.

-s ADDR

Bind to local address. This allow you to specify the multicast source of the packets sent by your beacon.

-d FILE

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.

-I NUMBER, -interval NUMBER

Interval between refresh of the dump file. Defaults to 5 secs if not specified

-W URL, -website URL

Specify a website to announce.

-Wm URL, -matrix URL

Specify your matrix URL.

-Wl URL, -lg URL

Specify your looking glass URL.

-C CC

Specify your two letter Country Code.

-L program

Launch program after each dump. The first argument will be the dump filename.

-F flag

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)

-pidfile FILE

Path to the PID file to write to.

-syslog

Outputs using syslog facility.

-c FILE

Specifies the configuration file to use. Each of the above command-line parameters can be defined there.

-V, -version

Outputs version information and leaves