NAME

net-mqtt-trace - Perl script for decoding MQTT messages from IP packets

VERSION

version 1.143260

SYNOPSIS

  net-mqtt-trace [options] {dev|dumpfile}

  # live decode
  # decode MQTT packets that are visible on the interface eth0
  net-mqtt-trace eth0

  # batch decode
  # sniff 100 MQTT packets from eth0 and write them to mqtt.tcp
  # then later decode MQTT messages from tcpdump file
  tcpdump -w mqtt.tcp -i eth0 -c 100 -s 4096 tcp and port 1883
  net-mqtt-trace mqtt.tcp

DESCRIPTION

This script is an MQTT message decoder for IP packets. Packets can be decoded live by sniffing traffic on a network interface or they can be batched processed by reading them from a tcpdump file.

OPTIONS

-help: Print a brief help message.
-man: Print the manual page.
-verbose: Include more verbose output. By default, the start and end of processing produce a little output. This option turns on further output including a summary of the counts of different packets decoded.
-quiet: Remove even the basic verbose output.
-link: Print link layer - assumed to be Ethernet - information. This option may be repeated to get further output.
-ip: Print ip layer information. This option may be repeated to get further output.
-tcp: Print TCP layer information. This option may be repeated to get further output.
-mqtt: Print MQTT message information. This option may be repeated to get further output.
-count NNN: Stop processing after the given number of packets. The default is to process all packets.
-snaplen NNN: Maximum length of data to capture for each packet. Default is 65535. This is only used when capturing directly from a device.
-promisc: Turn on promiscuous mode. Default is off. This is only used when capturing directly from a device.
-timeout NNN: The read timeout in milliseconds. Default is 0 (no timeout). This is only used when capturing directly from a device.

AUTHOR

Mark Hindess <soft-cpan@temporalanomaly.com>

COPYRIGHT AND LICENSE

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.