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

FreeBSD Manual Pages

  
 
  

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

NAME
       dbeacon - Distributed IPv4/IPv6 multicast beacon

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]

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

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

       -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  com-
	      mand-line	parameters can be defined there.

       -V, -version
	      Outputs version information and leaves

BUGS
       Should	 be    reported	   to	the   core   developer	 Hugo	Santos
       <hugo@fivebits.net>.

HISTORY
       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)

NAME | SYNOPSYS | DESCRIPTION | OPTIONS | BUGS | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dbeacon&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help