bcmc 0.0.4

a CLI-centric broadcast and multicast validation tool

 _
| |__   ___ _ __ ___   ___   _ __  _   _
| '_ \ / __| '_ ` _ \ / __| | '_ \| | | |
| |_) | (__| | | | | | (__ _| |_) | |_| |
|_.__/ \___|_| |_| |_|\___(_) .__/ \__, |
                            |_|    |___/

bcmc is a CLI-centric IP broadcast and multicast tool built with Python. it is a testing tool for generating and validating broadcast or multicast traffic.

bcmc can be run as a server to generate broadcast or multicast traffic or bcmc can be run as a client to receive broadcast or multicast traffic. it is a CLI-based client/server tool inspired by iperf.

bcmc is developed by Josh Schmelzle and Kevin L. Marshall and is released under a three-clause BSD license.

why bcmc?

Existing tools such as Multicast Hammer are platform specific and may have unsupported system dependencies on modern OSes. bcmc aims to be a free cross-platform tool that can be used from *unix or Windows. While bcmc aims to function cross-platform, please note some optional features may not work on certain OSes.

usage

bcmc is a client/server tool similar to how iperf functions. bcmc can be used to test and validate broadcast or multicast on 802.11 or 802.3 networks. You will need two hosts; one to run bcmc in client (receive) mode and one to run bcmc in server (transmit) mode.

broadcast traffic

In broadcast mode, the default behavior for bcmc is to send IP layer UDP packets to 255.255.255.255.

multicast traffic

In multicast mode, the default behavior for bcmc is to send IP layer UDP packets to 239.0.0.2 as the multicast group address.

modes (-s|-c)

bcmc can be run as client or server.

traffic (-bc|-mc)

bcmc can generate broadcast or multicast IP packets.

broadcast (-bc)

client usage:

bcmc -c -bc

server usage:

bcmc -s -bc

multicast (-mc)

client usage:

bcmc -c -mc

server usage:

bcmc -s -mc

optional arguments

usage: bcmc [-s|-c] [-bc|-mc] [options]
       bcmc [-h|--help] [-v|--version]

optional arguments:
  -h, --help            show this help message and exit
  -p 2002, --port 2002  port to listen on/connect to
  -b <host>, --bind <host>
                        bind to the interface associated with provided <host> address
  -c, --client          run in client mode
  -s, --server          run in client mode
  -bc, --broadcast      set traffic type to broadcast
  -mc, --multicast      set traffic type to multicast
  --group 239.0.0.2     multicast group address (239.0.0.2 by default)
  -i 1, --interval 1    interval to send multicast packets
  --dscp 46             set the Differentiated Service Code Point value applied to packets sent in server mode
  --padding 0           number of additional null bytes per payload sent in server mode