NAME

       hpav - HomePlug AV Packet Listener

SYNOPSIS

       hpav [options]

DESCRIPTION

       Display  HomePlug  AV  Ethernet  messages  sent  by a local powerline device to the host or the broadcast
       address.  Do not display HomePlug AV frames sent from the host to powerline  devices  or  forwarded  over
       powerline through the local powerline devices.

       The  program is an example of a simple packet listener and daemon.  Engineers and software developers can
       extend it to build custom sniffers or servers.  The framework is present but additional features must  be
       added.

       This program is part of the Qualcomm Atheros Powerline Toolkit.  See the plc man page for an overview and
       installation instructions.

OPTIONS

       -i interface
              Names  the  host  ethernet interface to watch.  The named interface, such as eth0, eth1 and so on,
              must be connected to a HomePlug AV ethernet-to-powerline bridge adapter to receive any HomePlug AV
              traffic.  The default interface is eth1.

       -q     Quiet mode.  Suppress the printing of the normal message descriptions on stdout.

       -v     Verbose mode.  Displays incoming frames in hexadecimal dump format  on  stdout.   This  option  is
              independent of option -a which prints VS_ARPC message text on stderr.

       -?, --help
              Print  program  help  summary  on  stdout.  This option takes precedence over other options on the
              command line.

       -!, --version
              Print program version information on stdout.  This option takes precedence over other  options  on
              the  command line.  Use this option when sending screen dumps to Atheros Technical Support so that
              they know exactly which version of  the  Linux  Toolkit  you  are  using.   See  the  HomePlug  AV
              Specification  for  a  description  of  all  HomePlug  AV message types.  See the Qualcomm Atheros
              INT6000 Firmware Reference Manual for a description of Atheros Vendor Specific message types.

EXAMPLES

       The following command monitors the default host interface eth1 for HomePlug AV traffic and dumps detected
       frames on the console as they arrive.  To terminate the process, type ^C or  ^Z  at  the  console.   This
       program is usually run in a separate console window while performing powerline operations.

          # hpav

       The  following command monitors host interface eth4 for incoming HomePlug AV frames and dumps writes them
       to file hpav.log.  Frames are printed in hexadecimal dump format because option -v is present.  Terminate
       the foreground process by typing ^C or ^Z at the console.

          # hpav -v -i eth4 > hpav.log

DISCLAIMER

       Atheros HomePlug AV Vendor Specific Management Message structure and content is proprietary  to  Qualcomm
       Atheros, Ocala FL USA.  Consequently, public information is not available.  Qualcomm Atheros reserves the
       right  to  modify  management  message  structure  and  content  in  future firmware releases without any
       obligation to notify or compensate users of this program.

SEE ALSO

       plc(1), efru(1), efsu(1), mme(1)

CREDITS

        Charles Maier

open-plc-utils-0.0.3                              November 2013                                          hpav(1)