NAME

       pibdump - Qualcomm Atheros Parameter Information Block Dump Utility

SYNOPSIS

       pibdump [options] file [>stdout]

DESCRIPTION

       Read  a  Qualcomm  Atheros  powerline  parameter information block (PIB) file and print an
       object driven dump on stdout.  This program replaces program odd because it  distinguishes
       between legacy and current PIB file formats.

       An  object  driven dump requires an object definition file that lists the size and name of
       data objects (ie; integers, arrays or structures) within the parameter  file.   Individual
       data members are presented as smaller, individual data dumps within a larger, overall data
       dump.

OPTIONS

       -f file
              The object definition file that lists the size, name and description of  individual
              individual  objects  in  order of occurance.  If this option is omitted then object
              definitions are read from stdin.  The object definition file  is  not  modified  by
              this program.

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

ARGUMENTS

       file   The  name  of  a  binary  file.  The file must have either Thunderbolt/Lightning or
              Panther/Lynx format or output will be incorrect.  The file is not modified by  this
              program.  Only one such file is permitted on the command line.

EXAMPLES

       The  following  is an example object definition file for an Ethernet frame.  Frame fields,
       like ODA, OSA and ETHTYPE,  are defined by length in order of their appears in the  frame.
       Array  subscripts  following object names are optional but, if present, become part of the
       object name.  Fields having no length are headers and will be ignored.  Comments and blank
       lines are also ignored.

          # ========================================
          #
          # ----------------------------------------

          0 header

          6 ODA[6] Own Destination Address
          6 OSA[6] Own Source Address
          2 ETHTYPE Ethertype or frame length

          # ========================================
          #
          # ----------------------------------------

          0 body

          1500 Payload[1500]

          # ========================================
          #
          # ----------------------------------------

          0 trailer

          4 CRC Cyclical Redundancy Check

       The following command uses object definition file ether.txt to identify and display member
       fields within binary file abc.bin in hexadecimal dump format.

          # pibdump -f ether.txt abc.bin

SEE ALSO

       chkpib(7), chkpib2(7), getpib(7), modpib(1), pib2xml(1), pibcomp(1), setpib(1), xml2pib(1)

CREDITS

        Charles Maier