Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
dbeacon(1)		    General Commands Manual		    dbeacon(1)

       dbeacon - Distributed IPv4/IPv6 multicast beacon

       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]

       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  mul-
       ticast 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.

       -n NAME,	-name NAME
	      The name identifying you on the dbeacon session. If  not	speci-
	      fied, 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

       -i IN, -interface IN
	      Use IN instead of	the default interface for multicast.

	      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.

	      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  bro-
	      ken 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  ma-

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

	      Outputs using syslog facility.

       -c FILE
	      Specifies	the configuration file to use. Each of the above  com-
	      mand-line	parameters can be defined there.

       -V, -version
	      Outputs version information and leaves

       Should	 be    reported	   to	the   core   developer	 Hugo	Santos

       dbeacon is a joint work of Hugo Santos, Sebastien Chaumontet and	 Mick-
       ael  Hoerdt. It has been	done in	the early days of the m6bone, when no-
       body 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)


Want to link to this manual page? Use this URL:

home | help